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cepts and facilities of RJE which allow users at remote 
locations to submit jobs over communication lines to an 
IBM System/360 using the Operating System that provides 
multiprogramming with a variable number of tasks. 
Information on the capabilities and uses, the operating 
environment, and work station states and activities is 
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The Job Entry Control Language is introduced and 
explained. The Job Entry Definition Statement, work 
station commands, messages sent to work stations, and 
central commands are discussed in terms of their func- 
tions, and how the user employs them in programs. 

A discussion of RJE generation includes the neces- 
sary macro instructions. Communication Serviceability 
Facilities, such as error recovery procedures, and sys- 
tem restart procedures are discussed separately as well 
as with the work stations. 
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PREFACE 



Remote Job Entry (RJE) extends Operating 
System facilities to remote users. This 
publication describes the facilities pro- 
vided by RJE, the use of these facilities 
and the creation of an RJE system. A brief 
description of the related telecommunica- 
tions systems is included. Operating pro- 
cedures are defined for the central instal- 
lation and the various work stations. This 
publication also introduces Job Entry Con- 
trol Language (JECL) with which a user 
requests -, controls, and maintains RJE faci- 
lities in the system. 



The RJE user should be familiar with the 
concepts and terminology introduced in: 

IBM System/360 Operating System : 

I ntroduction , Form C28-6534 

Concepts and Facilities , Form C28-6535 

Job Control Language , Form C28-6539 

The installation programmer responsible 
for the creation and maintenance of the 
central RJE system also should be familiar 
with: 

IBM System/360 Operating System : 

System Generation , Form C28-6554 

Basic Telecommunications Access Method , 
Form C30-2004 

System Programmer's Guide , Form C28-6550 

Publications relevant to programming and 
operation of remote work stations are: 



IBM System/360 work station 

IBM System/360 Basic Operating System : 

System Generation and Maintenance , Form 
C24-5060 

Programmer's Guide , Form C24-3372 

Operating Guide , Form C2U-3450 

Operator Messages , Form C24-502U 

Assembler With Input/Output Macros , Form 
C24-3361 

IBM System/360 Basic Programming Support 
Programmer ' s Guide , Form C24-3354 

Operating Guide - Basic Tape Syste m 
(8K) , Form C24-3391 

System Generation and Maintenance , Form 
C2U-5061 

Assembler With Input/Output Macros , Form 
C24-3355 

IBM 2780 Data Transmission Terminal work 
station 

IBM 2780 Data Transmission Terminal Com- 
ponent Description , Form A27-3005 

IBM 1130 Computing System work station 

IBM 1130 Functional Characteristic s, 
Form A26-5881 

IBM 1130 Disk Monitor System, Version 2, 
Programming and Operator's Guide , Form 
C26-3717 



Second Editio n (May 1968) 

This edition is a major revision of the Remote Job Entry manual (Form 
C30-2006-0) for Release 15/16 of the Operating System. Coincident with 
Release 15/16 and issuance of this edition, the following manual is 
obsoleted: C30-2006-0 with Technical Newsletters N30-5016, N30-2506, 
and N30-2509. 

Specifications contained herein are subject to change from time to 
time. Any such changes will be reported in subsequent revisions or 
Technical Newsletters. 

Requests for copies of IBM publications should be made to your IBM 
representative or to the IBM branch office serving your locality. 

A form is provided at the back of this publication for reader's 
comments. If the form has been removed, comments may be addressed to 
IBM Corporation, Programming Documentation, P.O. Box 12275, Research 
Triangle Park, North Carolina 27709 
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INTRODUCTION 



The Remote Job Entry (RJE) facility of 
the Operating System (OS) provides , for an 
IBM System/360 with attached communication 
lines, an efficient and convenient method 
of entering jobs submitted from remote work 
stations into the job stream. Once a job 
has been entered into the job stream by 
RJE, execution of the job proceeds under 
the supervision of Operating System job 
management routines. All data sets created 
by the job are handled by the Operating 
System data management routines. Output 
data sets which have been created by 
remotely submitted jobs and which are to be 
returned to the remote user are placed in a 
separate output class. These data sets are 
removed from this output class and returned 
to the remote user under the direction of 
the RJE program. This type of operation 
provides a remote user with the same batch- 
computing facility that is available at the 
central installation. 

The capability to accept input automat- 
ically from remote stations greatly 
increases the need for strong system disci- 
pline. For example, if a job requiring 
data sets at the central installation is to 
be submitted, the volume containing the 
data set involved must be available for 
prompt mounting. Otherwise, the system job 
flow can be upset or interrupted. A job 
requiring a large amount of core storage 
also can cause a system problem since pro- 
cessing is delayed until core storage is 
available. 

The Remote Job Entry system provides 
several facilities to assist installation 
managers in controlling access to the sys- 
tem, to regulate job flow, and to provide 
information on system status. User exits 
(to examine JOB cards, for instance) , the 
broadcast facility, remote and central mes- 
sages, and the Job Entry Control Language 
are provided for orderly and efficient sys- 
tem control. 



close to the source of input with high 
speed communication lines. 



EQUIPMENT AT THE CENTRAL COMPUTING SYSTEM 

Remote Job Entry operation is possible 
with an IBM System/360 having at least 51ZK 
bytes of main storage and using the Operat- 
ing System which provides multiprogramming 
with a variable number of tasks (MVT) . The 
only additions to the minimum requirements 
for MVT are: 

1. An IBM 2701 Data Adapter Unit with 
Synchronous Data Adapter - Type II, or 
an IBM 2703 Telecommunications Control 
Unit, with the, binary synchronous fea- 
tures, equipped for EBCDIC code and 
full transparency operation. The dual 
communications interface feature is 
supported on the 2701. 

2. Direct Access Storage space for RJE 
tables is typically less than one IBM 
2311 Direct Access Storage Device 

(DASD) or IBM 2314 Storage Facility 
disk pack. Exact requirements depend 
on the number of jobs, users, and work 
stations supported by the system, and 
the direct access device used (see 
Appendix B) . 

3. Direct access space for SYSIN data 
from remotely submitted jobs. The 
space required is dependent on the 
SYSIN requirements for the 
installations . 

For example, a system allowing up to 100 
active remote jobs, 10 work stations, and 
30 users would require 18 tracks of 2311 
DASD storage for RJE tables plus the addi- 
tional SYSIN requirements. 



REMOTE WORK STATIONS SUPPORTED 



RJE not only provides a means for effi- 
cient operation of computing facilities by 
equipment centralization, but also gives 
substantial computing power on a demand 
basis to locations not requiring it on a 
regular basis. In addition, it allows 
sharing of a common body of information 
within a company by widely separated 
organizational units having related 
requi r ements . 

RJE provides fast turnaround of computer 
requirements for people in all parts of a 
company by placing the computer facilities 



Any of three devices can serve as work 
stations in the RJE system. 



IBM SYSTEM/360 

An IBM System/360, 16K or larger, may be 
used as an RJE work station. It can be 
connected to the central System/360 via a 
switched or nonswitched, point-to-point 
contention, communications line through an 
IBM 2701 Data Adapter Unit with Synchronous 
Data Adapter, Type II with EBCDIC 
transparency . 
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The following I/O units are required for 
RJE operation: 

1. Card reader and card punch, or a card 
read punch 

2 . Printer 

3. 1052 Printer-Keyboard 



In addition, the following 2780 special 
features are supported: 

1 . Multipoint Line Control 

2. Multiple Record Transmission 



RJE also supports the following special 
features on the 2701: 



1. Auto Call 

2. Dual Communications Interface 



IBM 2780 DATA TRANSMISSION TERMINAL 



The IBM 2780 Data Transmission Terminal 
(Model 1 or 2) may be used as an RJE work 
station. It can be connected to the cen- 
tral System/360 by a switched or non- 
switched point-to-point contention line, or 
a nonswitched multipoint line. The follow- 
ing special features are required: 



1. EBCDIC Transmission Code 

2. EBCDIC Transparency 

3. Print Line (either 120-character or 
1 4 4-- character) 

4. Auto Turnaround (only required on 
Model 2) 

5. Extended (Enquiry-ENQ) Retry 
Transmission 



IBM 1130 COMPUTING SYSTEM 

An IBM 1130 Computing System may also be 
used as an RJE work station. The 1130 work 
station requires an 1131 CPU (Central Pro- 
cessing Unit) , including a console printer- 
keyboard, with a single disk storage drive 
and at least 8K words of core storage. The 
system is connected to a 1200-2400 bit-per- 
second line via a Synchronous Communica- 
tions Adapter in binary mode. The line may 
be a switched or a nonswitched, point-to- 
point line, or a nonswitched multipoint 
line. 

The following I/O units are required for 
RJE operation: 

1 . Card reader and card punch or a card 
read- punch. 

2. Line printer with 120-character print 
line. 

The following special features are 
supported: 

1 . One or more disk storage drives for 
input . 

2. One disk storage drive for output.. 



RJE TELECOMMUNICATIONS CONCEPTS AND TERMINOLOGY 



This section describes the basic charac- 
teristics and operational concepts of the 
Remote Job Entry telecommunications system: 
what it is, how its sections are related, 
how communication proceeds, and how control 
is maintained. A number of commonly used 
terms are defined. 

The RJE system is, in effect, a specific 
application of a computer-based telecom- 
munications system. The particular tele- 
communications system used for Remote Job 
Entry is characterized by a number of work 
stations which are connected to a central 
processor by one or more communication 
lines operating in half -duplex mode. A 
half-duplex line is a line over which data 
can flow in either direction, but in only 
one direction at a time. 

The RJE program uses the OS/360 Basic 
Telecommunications Access Method (BTAM) to 
control the communication lines and commun- 
icate with the work stations. Work station 
is used as a general term to represent 
interconnected equipment at the remote 
location having both input and output capa- 
bility. Work stations are usually 
separated from the central processor by a 
distance sufficient to require common car- 
rier facilities to accomplish communication 
with the central processor. The system, 
however, may include work stations attached- 
to the central location by local lines. 
Regardless of location, all supported work 
stations are classified as "remote" since 
they are attached to the central system by 
an IBM 2701 or 2703 telecommini cations con- 
trol unit. 



TELECOMMUNICATIONS NETWORKS 

A telecommunications system may utilize 
a nonswitched network, a switched network, 
or a combination of the two. 

A nonswitched network consists of a 
number of private or leased lines that con- 
nect the computer to one or more work sta- 
tions. The computer and work stations are 
physically connected; that is, the circuits 
making up the communication lines are con- 
tinuously established for predetermined 
time periods during which data may be 
transmitted over them. The lines that com- 
prise a nonswitched network are known 
variously as private, leased, or dedicated 
lines. These lines are usually furnished 
by a common carrier on a contract basis 
between specified locations for a con- 
tinuous period or for regularly recurring 



periods at stated hours for the exclusive 
use of one customer. 

A switched network allows many work sta- 
tions to communicate with the computer 
without requiring dedicated communication 
connections. The computer and the several 
work stations are connected by access lines 
to the common- carrier exchanges serving 
their respective locations. A complete and 
continuous data path is established between 
computer and work station only for the 
period of time in which transmission takes 
place. The connection is established by 
dialing the telephone number of the unit at 
the other end. In this case, line refers 
to a discrete data path between the tele- 
communications control unit and the common 
carrier exchange. The service provided by 
the common carrier is usually on a time- 
used basis. 

Some communication networks have charac- 
teristics typical of both switched and non- 
switched networks. In this publication, 
the term switched network refers to any 
network in which a direct physical connec- 
tion between computer and work station must 
be established by dialing in order for data 
transmission to occur. The term non- 
switched network refers to a network in 
which the communication lines linking com- 
puter and work station are continuously 
established, thus requiring no dialing. 



NETWORK CONTROL 

Initial contact between the central sys- 
tem and the remote work stations in an RJE 
system may occur in two ways, dependent on 
the type of line connection between them. 
The connections possible are multipoint (on 
nonswitched lines) and point-to-point con- 
tention (on both switched and nonswitched 
lines) . The RJE system permits communica- 
tion using either type of connection. 

If a work station is connected via a 
multipoint line , data is sent and received 
under control of the central system. In 
order to send data, the work station must 
be polled by the central system. In order 
to receive data, the work station must be 
selected by the central system. Polling is 
an invitation to a work station to transmit 
data to the central system. Once a work 
station has accepted this invitation 
(through recognition of its polling charac- 
ters) , it may use the line to send data. 
When it has finished, it sends the central 
system an End-of-Transmission (EOT) 
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character. At such time, the central sys- 
tem is again free to poll or select another 
work station . 

Selection , on the other hand, is an 
invitation to a work station to receive 
data from the central system. If it is a 
multiple component work station (more than 
one output device, for example, the IBM 
2780) , the selection characters specify the 
component which is to receive the data. 
When the central system has finished trans- 
mitting, it sends an End-of -Transmission 
character and polls or selects another work 
station on the line. Selection normally 
has precedence over polling. That is, 
after initial contact, output is sent by 
the central system before any input is 
collected from a work station. 

The other type of line connection poss- 
ible in an RJE system is poi nt- to- poi nt 
contention , with one work station connected 
over a switched or nonswitched line. On a 
nonswitched line, either the central system 



or the work station may initiate transmis- 
sion of data after the work station is log- 
ically attached to the system. The central 
system always yields to a work station, 
even though it may itself desire to 
transmit. 

Over switched lines (dial connection) , 
operation is similar to nonswitched once 
initial contact has been made. In the RJE 
communications environment, the central 
system never initiates communications with 
a work station on a switched line. The 
central system breaks the connection only 
after receiving a disconnect sequence or an 
RJEND command from the work station. (Re- 
fer to the section on Work Station Commands 
for a description of the RJEND command.) 

Data transmission in the RJE system uses 
binary synchronous communication in the 
EBCDIC transparent mode of transmission. 
The transparent mode of comminication 
allows transmission of the full EBCDIC 
character set as data. 
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RJE CONCEPTS AND FACILITIES 



GENERAL CONCEPTS 

Remote Job Entry controls a flow of data 
and processes that data as required. Data 
entering from remote sources is the primary 
input to the RJE system and consists of job 
entries and commands. Commands are also 
entered by the central operator. 

Jobs submitted by remote users are 
passed to OS/360 for scheduling and execu- 
tion. When the output resulting from these 
jobs becomes available, it is returned to 
the user as requested — either immediately 
or on command. 



OPERATING ENVIRONMENT 

RJE operates in conjunction with Operat- 
ing System Option 4 (MVT) as a system task, 
much like a combined reader and output 
writer. Jobs received from the work sta- 
tion are scheduled for subsequent execu- 
tion. When a remotely submitted job is 
completed, the job output is placed in a 
common SYSOUT class for RJE. RJE removes 
the output from this class and returns it 
to the work stations as directed. 



RJE FACILITIES 

In addition to those facilities provided 
by OS/360, the RJE user is provided with 
the following capabilities: 

• He can submit a job via communication 
line to the central system from a 
remote location. This job is submitted 
just as it would be at a local card 
reader except for the possible addition 
of control statements requesting spe- 
cial RJE processing. 

• Using the command language provided, 
the RJE user can request services not 
otherwise available in the remote 
environment. The work station commands 
are: 



5. OUTPUT 



CONTINUE 



1 



RJ START 



2. 


RJEND 


3. 


LOGON 


4. 


LOGOFF 



- Attach a work station to 
the RJE system. 

- Detach a work station 
from the RJE system. 

- Attach a user to the JRE 
system. 

- Detach a user from the 
RJE system. 
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DELETE 



ALERT 



STATUS 



BRDCSTR 



MSGR 



- Retrieve selected job 
output. 

- Continue interrupted in- 
process output. 

- Delete a selected job or 
jobs from the RJE system. 

- Request notification of 
selected job completion. 

- Retrieve selected job 
status . 

- Retrieve broadcast mes- 
sages containing system 
status from the central 
system. 

- Send a message to a work 
station or to the central 
operator. 



• The user can specify that job output be 
returned either immediately or on 
command. 

• He can direct job output, to himself, to 
an alternate user, or to the central 
system output devices. Only the user 
who submits the job or an alternate 
specified by him can receive job 
output. 

• The user can request notification of 
job completion, including an indication 
of normal or abnormal termination, and 
other user-supplied information. 

• The remote operator can discontinue 
in-process output and continue it at a 
later time by command. 

• The user can specify form numbers for 
each output data set. When a change in 
form number occurs, output is discon- 
tinued, and a message is sent to the 
remote operator who may continue the 
output when the form requirement is 
satisfied. 

• The central operator, using commands 
provided him, can supervise the central 
system and communicate with remote 
users. The central commands are: 

1 . START - Begin RJE operation at 

the central installation. 

2. STOP - Cease RJE operation at 

the central installation. 
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USERID - Add users to or delete 
users from the system. 

CENOUT - Cause output from remote- 
ly submitted jons to be 
written locally. 

SHOW - Display information per- 
taining to RJE. 



6. MSG 



Send a message to a work 
station. 



BRDCST - Maintain information in 
the broadcast data set. 



WORK STATION STATES 

In describing the Remote Job Entry sys- 
tem, it is convenient to refer to work sta- 
tions in the following states: inactive , 
activ e, and processing . These states 
reflect the appearances a work station may 
give to the central system. On the basis 
of the state of a work station, the central 
system determines what communication is 
permitted. While all three states may be 
found in the RJE system at a given time, a 
specific work station is in only one state 
at a time. The movement between states is 
controlled by the work station through 
various JECL commands sent to the central 
system. When one of these commands repre- 
senting a valid change of state is 
received, operation proceeds in the new 
state until another valid change is speci- 
fied by the work station. Invalid requests 
are not serviced, and an error message is 
sent to the work station which made the 
request. 

After startup procedures have been com- 
pleted at the central system, it is ready 
to service the work stations. At this time 
all work stations appear in the inactive 
state . 



INACTIVE 

All work stations are placed in the 
inactive state when the central system is 
closed down. A work station in an active 
or procecessing state becomes inactive by 
submitting an RJEND command. When a work 
station is in the inactive state, it is 
logically detached from the RJE system. 
The central system assumes that an inactive 
work station does not want to participate 
in RJE activities and, consequently, it 
does not initiate any transmissions to the 
station. However, it is conditioned to 
receive an RJSTART command from an inactive 
work station. If any other input is 
received from an inactive work station, it 



is refused, and an error message is 
returned to the work station. The RJSTART 
command changes a work station from an 
inactive state to an active state. 



ACTIVE 

Work stations enter the active state 
when the central system receives an RJSTART 
command from an inactive work station or a 
LOGOFF command from a processing work sta- 
tion. Active work stations are logically 
attached to the RJE system. The central 
system can initiate transmissions to active 
work stations. These transmissions con- 
sists of any work station output which is 
on the work station output queue. Work 
station output is any output that is 
directed to the work station whether or not 
a valid user is logged on at the work sta- 
tion, for example, immediate job output and 
source notification messages. Broadcast 
messages are transmitted to active work 
stations if requested. 

When the central system receives a valid 
RJSTART command, the work station is logi- 
cally attached to the RJE system. When the 
central system receives a valid LOGOFF com- 
mand (from a processing station) , the cur- 
rent user is detached from the RJE system, 
but the work station reverts to the active 
state and remains attached. The central 
system is conditioned to receive only a 
LOGON, an RJEND, or a CONTINUE command from 
an active work station. If any other input 
is sent from an active work station, it is 
rejected, and an error message is returned 
to the work station. 



PROCESSING 

An active work station enters the pro- 
cessing state when the central system 
receives a valid LOGON command. The LOGON 
command indicates that a user desires 
access to the RJE system. RJE input is 
accepted by the central system only from 
processing work stations. RJE input con- 
sists of job entries and work station com- 
mands. In addition, the central system 
transmits work station output and user out- 
put to a processing work station if the 
work station has no input to submit. User 
output is that output which is returned 
only if the user is logged on at the work 
station. 

The central system is conditioned to 
receive any input from a processing work 
station. However, if the work station 
transmits any of those control statements 
which specify a change of state, it assumes 
the new state. 
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Figure 1 . 



Transition of Work Station 
States 



brought on-line, as outlined in the sec- 
tions of this manual dealing with the 
various work stations supported by RJE. 
The procedure for attaching the work sta- 
tion once these procedures are executed is 
the same for all work stations, that is, 
submitting the R J START command. 



WORK STATION CLOSEDOWN 

A work station terminates RJE activites 
(closedown) with the RJEND command. This 
command initiates logical detachment of the 
work station from the system. The central 
system first responds with any pending mes- 
sages. It then places the work station in 
an inactive state. When the work station 
receives the message that the closedown 
procedures are complete, it is free to be 
used for local processing. In addition, if 
the work station is connected to the cen- 
tral system with a switched line, the con- 
nection is broken, and the line is avail- 
able for another work station. 



Figure 1 shows the three states and the 
commands leading to and from these states. 



USER ACCESS 



STARTUP AND CLOSEDOWN 

When the central system is in operation, 
remote work station users may begin and end 
RJE activities at will. When the central 
system ceases operation, all work stations 
are closed down. 



CENTRAL STARTUP AND CLOSEDOWN 

Central startup and closedown are 
achieved by the START and STOP commands 
provided for the central operator. When 
startup is initiated by the START command, 
a message is sent to the central operator 
indicating that the RJE task is in opera- 
tion. When closedown is initiated by the 
STOP command, a message is sent to the 
operator indicating completion of the RJE 
task. 



WORK STATION STARTUP 

A work station starts up in the RJE sys- 
tem by submitting the RJSTART command to 
identify it to the system. This command, 
if accepted as valid by the central system, 
places the work station in the active 
state. A user now may gain access to the 
system from this work station by logging 
on, or the work station may simply wait for 
work station output directed to it. Of 
course, before sending the command to the 
central system, the work station must be 



A user gains access to the RJE system by 
submitting the LOGON command at an active 
work station. This procedure insures that 
only valid users have access to the RJE 
system (especially critical on switched 
networks) . If he is identified as a valid 
RJE user, he may submit input to the cen- 
tral system or request job output. The 
period during which a user is actively 
engaged in remote job entry is a session . 
A session begins when a valid LOGON command 
is received and ends with the LOGOFF com- 
mand. A user may submit input and receive 
output at any work station in the system. 
When he is not logged on, a user is asso- 
ciated with the last work station at which 
he was logged on. 



SYSTEM SECURITY 

The system is protected from unautho- 
rized access through the use of an identi- 
fication and protection key sequence in the 
LOGON command (see section on LOGON 
Command) . 

Verification of valid RJE users is esta- 
blished at LOGON time with the user identi- 
fication (user id) and protection key. 

Output from a remotely submitted job is 
further protected in that it may be 
requested only by a recipient named in the 
Job Entry Definition (JED) for that job or 
by the originator. 
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INPUT AT THE WORK STATION 

The input stream at the remote work sta- 
tion comprises job entries and work station 
commands. 



JOB ENTRY 

The job entry is the primary input of 
Remote Job Entry system. It is a combina- 
tion of the job to be executed at the cen- 
tral system and the optional RJE control 
statement, that is, the Job Entry Defini- 
tion statement (JED) . This optional state- 
ment specifies certain actions to be taken 
in processing the job by RJE. If the JED 
is not specified, system options are 
assumed when the job is received. 

The jobname found in the JOB statement 
identifies the job entry to RJE. This 
allows the RJE user to request and receive 
job output and job information by jobname — 
a name which the user specifies. RJE 
operation requires individual jobnames. If 
a job with the same name as a job already 
in the system is recived, the second job is 
rejected and a message is sent to the user. 
Once the user has either received the job 
output or deleted the job he is free to 
reuse that jobname. Duplicate jobnames can 
be avoided if users begin their jobnames 
with their own unique userids. 



WORK STATION COMMANDS 

The user makes specific requests of the 
RJE system via work station commands. Work 
station commands may be entered through the 
card reader or the printer-keyboard. If 
the commands are entered through the card 
reader, they may appear anywhere within the 
input stream except within a job entry. A 
detailed description of the work station 
commands is given in the section describing 
Job Entry Control Language. 



OUTPUT AT THE WORK STATION 

Two kinds of output are received at the 
work station: job output and messages. 



JOB OUTPUT 

Job output is the result of execution of 
remotely submitted jobs. Job output 
includes job management messages and output 
data sets created by the job. The output 
data sets to be returned to the user must 
be specified as SYSOUT. The remote device 
to which the output is returned is speci- 
fied by the class in the SYSOUT keyword. 
Macro instructions used during the RJE 
assembly process allow the specification of 



remote SYSOUT classes consistent with those 
used at the central system. That is, if 
class A normally represents a central 
printer, the RJE system is assembled so 
that class A in a remotely submitted job 
causes output to be directed to the remote 
work station printer. 

RJE supports output to a remote printer 
and punch. In addition, JRE provides an 
exit for remote computers allowing a user- 
written routine to write output to any 
available device. Each remotely submitted 
job can generate a maximum of 24 SYSOUT 
data sets to be returned to the remote work 
station. Any data set beyond the 24 maxi- 
mum is automatically directed to the work 
station printer. 

Note : The SYSOUT designation must be used 
even though the remote work station is a 
2780 or a computer with an operating system 
which does not support a SYSOUT designa- 
tion. The RJE program determines the dis- 
position from the SYSOUT parameter on 'the 
DD statement . 

Job management messages, including diag- 
nostics of job control statements and allo- 
cation and deallocation messages, are 
always returned to the work station. 
Results of Write-To-Operator macros within 
a job and of password requests for password 
data sets are directed to the printer- 
keyboard of the central system and are not 
available at the work station. 

Output Control 

Output at the work stations also 
involves a number of options which are 
specified in the job entry definition 
statement (JED) and work station commands. 

• The output may be directed to the 
source work station as soon as the job 
is completed and the work station is 
available to receive it. 

• The output may be left at the central 
system until the user requests it. 

• The output may be directed to an 
alternate user by the originator. 

• Output may be requested at any work 
station either by the originator or by 
a user named as the alternate reci- 
pient. The recipient who first 
requests the output receives the only 
copy of the output . 

• The remote user makes multiple copies 
of his output available to either him- 
self or an alternate by writing his 
output to a named data set and submit- 
ting a job step which executes an OS/ 
360 data set utility program - IEBPTPCH 
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- to copy the output to SYSOUT. The 
IEBPTPCH program is described in the 
publication IBM System/360 Operating 
System Utilities , Form C28-6586. 

• Notification of job completion can be 
requested. This notification includes 
indication of normal or abnormal 
termination . 

Details of JECL specifications for out- 
put control are given in the section Job 
Entry Control Language. 



MESSAGES 

Messages received at a work station 
include: responses to input from the work 
station, diagnostic messages, messages sent 
by RJE users and the central operator, and 
broadcast messages maintained by the cen- 
tral operator and sent to a work station 
upon request. The broadcast messages 
include any information considered desir- 
able by the installation: closedown of the 
central system, loss of a central resource, 
or addition of a central resource, for 
example. 

If a work station has no printer- 
keyboard (for example, a 2780) , these mes- 
sages appear on the line printer between 
job outputs. If a work station has a 
printer-keyboard, a user may request that 
messages appear on it, rather than on the 
line printer. 

Detailed specifications for messages are 
given in the section describing Job Entry 
Control Language. 

FORMS REQUIREMENTS 

The form number subparameter of the SYS- 
OUT parameter is used to specify special 
forms requirements. A message is sent to 
the work station when RJE finds a form 
number that is different from the form 
number of the last data set sent to the 
same work station. This message includes 
the form number specified for the data set 
waiting to be sent. RJE then waits until 
it receives a CONTINUE command from the 
work station indicating that it is ready to 
receive the output. The operator at the 
work station submits this command when the 
proper forms have been inserted in the out- 
put device. When the CONTINUE command is 
received at the central system, output 
resumes until another change in form number 
is found, or the remote operator initiates 
action to discontinue output at the work 
station. Since the procedures for discon- 
tinuing output are dependent on the type of 
work station device, they are discussed 
separately under the operating procedures 
for each work station. 



SYSTEM OVERLOAD 

An overload condition results if direct 
access storage space at the central instal- 
lation is insufficient to meet the demands 
of the system. Input already received and 
acknowledged by RJE is not affected by an 
overload condition. Any input transmission 
causing an overload condition is aborted 
and must be entirely resubmitted at a later 
time. 

In each overload situation, a message is 
sent to both the central operator and the 
work station operator indicating the par- 
ticular resource depleted. If the system 
continues to be overloaded, the direct 
access storage space allotted for the 
resource must be increased to reflect more 
realistically the peak traffic requirements 
of the system. An alternate solution may 
be to reschedule the work load to take 
advantage of periods of relative 
inactivity. 

The total system input capacity is spe- 
cified by the central installation and is 
dependent on the following resources: 



• The quantity of SYS1 .SYSJOBQE space - 

specified at OS system generation 

• The number of concurrent jobs RJE is to 
maintain - specified at RJE assembly 

• The quantity of space for remotely sub- 
mitted SYSIN data - specified in an RJE 
cataloged procedure referenced in the 
START command for RJE 

SYS1. SYSJOBQE depletion results when job 
input submitted both locally and from 
attached work stations, exceeds the limit 
specified by the central installation. If 
this condition continues to occur, the size 
of the SYS 1. SYSJOBQE must be increased to 
reflect both the local and remote require- 
ments of the system. This will require 
that SYS 1. SYSJOBQE be scratched and 
reallocated. 

An overload condition also occurs when 
the number of remote jobs resident in the 
central system exceeds the limit specified 
when the RJE program was assembled. Remote 
jobs have residence until the output is 
removed from the RJE SYSOUT class. This 
condition is relieved by requesting the 
output of completed remote jobs or by 
deleting jobs which are tying up the sys- 
tem. The central operator can do this with 
the CENOUT command. The RJE user can do 
this with the OUTPUT and DELETE commands. 
If the condition continues to occur, the 
number of remote jobs RJE can maintain must 
be increased. This requires an RJE 
assembly. 
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Depletion of SYSIN space is the final 
cause of a system overload. In its cata- 
loged RJE procedure, the installation spec- 
ifies SYSIN data sets on a communication 
line basis. In this procedure, the instal- 
lation specifies the type of direct access 
device, the volume serial number to be used 
for the SYSIN data sets for this line, the 
blocking factor for SYSIN data sets, and 
the maximum space available for any one 
input data set. Specifying the maximum 



amount of space allocated for one input 
data set prevents one job from getting all 
the SYSIN space. This is a system protec- 
tion feature, and no special action is 
necessary at the central system if a job 
exceeds this limit. On the other hand,, a 
regular depletion of the toal SYSIN alloca- 
tion necessitates a new cataloged proce- 
dure, referenced at START RJE time, which 
makes more SYSIN space available to the 
system. 
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JOB ENTRY CONTROL LANGUAGE 



The additional flexibility and control 
required by the remote entry are provided 
in the RJE system by Job Entry Control Lan- 
guage (JECL) . JECL is independent of Job 
Control Language (JCL) , allowing system 
independence for RJE applications and iso- 
lation of those control statements needed 
only for an RJE application. As a result, 
only JECL statements are added or removed 
when a user moves between local and remote 
environments. The job and its scheduling 
information (in JCL) are the same in either 
environment. JECL uses the same coding 
format as that used for Job Control Lan- 
guage statements. 

The RJE user identifies himself and his 
work station to the system with JECL. When 
the user and the work station are identi- 
fied as part of the system, the user may 
request other RJE facilities with addition- 
al JECL statements . These other RJE facil- 
ities include the ability to: 

• Select job output control options 

• Communicate with the central operator 

• Communicate with other RJE users 

• Inquire about the status of jobs in the 
system 

• Receive notification of job completion 

• Detach the work station from the system 

• Continue transmission of interrupted 
output 

• Define RJE processing of a remotely 
submitted job 



JECL STATEMENTS 

Communication between the user and RJE 
processing programs is accomplished by two 
types of Job Entry Control statements : 

1. Job Entry Definition Statement 

2. Work Station Command Statement 

These control statements aid the RJE 
processing programs in the servicing of 
users and the supervision of work stations 
attached to the RJE system. 



THE JOB ENTRY DEFINITION STATEMENT 

The Job Entry Definition Statement 
(called the JED statement) marks the begin- 
ning of a job entry. It is the only JECL 
statement which may be continued on succes- 
sive cards. With the JED statement, the 
user specifies disposition of job output, 
notification at job completion, alternate 
recipient of the output, and information to 



be returned with notification. The JED 
statement is an optional statement. If a 
job in the input stream is not preceded by 
a JED statement or the JED statement is in 
error, RJE system default options are 
assumed. 



THE WORK STATION COMMAND STATEMENTS 

For the RJE user, work station command 
statements provide a convenient means of 
requesting RJE facilities to aid him in his 
application. They enable him to request 
output, determine the status of a job, 
specify the state of the work station, etc. 
A thorough discussion of the commands pro- 
vided and the facilities that they offer is 
provided in the section on Work Station 
Commands. 



FIELDS IN THE CONTROL STATEMENTS 

Control statements submitted at a work 
station contain two identifying characters 
(. .) and four fields: operation, operand, 
comment, and sequence. In some of the 
statements one or more of the fields are 
blank. Figure 2 shows the fields in each 
statement. 



Statement 


Columns 
1 &2 


Fields 
(Columns 4-71) 


Columns 
73-80 


Job Entry 
Definition 

Work Station 
Command 




JED Operand Comment* 

Operation Operand Comment* 
(Command) 


Sequence* 
Sequence* 



*Optional 

Figure 2. 



Fields in the Control 
Statements 



The operation field specifies the job 
entry definition statement or, in case of a 
command statement, the command. It can 
contain only one of the set of prescribed 
operations or commands. The operation 
field need not begin in a specific card 
column, but it must be preceded and fol- 
lowed by at least one blank. 

The operand field contains one or more 
parameters of information separated by com- 
mas. Parameters are described as values 
for which information must be substituted. 
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The operand field has no fixed length or 
column requirements but must be preceded 
and followed by at least one blank. 

The c omment field can contain any infor- 
mation considered helpful by the person who 
codes the control statement. It has no 
fixed length or column requirements but 
must be separated from the operand field by 
at least one blank. If the operand field 
is omitted, a comma followed by at least 
one blank indicates that comments follow. 



parameters and is characterized by a key- 
word followed by an equal sign and variable 
information. The variable information in 
keyword parameters can take the form of a 
list of several items (subparameters) of 
information. 



A list of subparameters must be enclosed 
in parentheses unless the list reduces to a 
single parameter. 



The s equence field contains up to eight 
characters of optional information used for 
control statement identification. It 
becomes especially useful in RJE since a 
number of similar commands may be submitted 
from the same work station. RJE returns 
the sequence field in all responses and 
diagnostics for JECL statements. The 
sequence field correlates the statement 
entered with the response received. With 
the use of the sequence field, therefore, 
the user can easily determine which state- 
ment is addressed by each response. The 
sequence field is positionally dependent 
and must be coded in the last eight columns 
(73-80) of the control statement. 

Identifying characters and fields are 
contained in columns 1 through 71 of the 
control statement. The total number of 
characters cannot exceed 71, except in a 
JED statement. Statement continuation is 
indicated by coding a nonblank character in 
column 72. 

Programmer ' s No te ; The only control state- 
ment which may be continued is the JED 
statement. 



DESCRIPTION OF CONTROL STATEMENTS 

Several conventions are followed in 
illustrating the format and coding of Job 
Entry Control Language: 

• Upper case letters, numbers, and punc- 
tuation marks must be coded by the pro- 
grammer exactly as shown. Exceptions 
to this convention are brackets, [ ] ; 
braces, [ }; elipses, ...; and sub- 
scripts. These are never coded. 

• Lower case letters and words represent 
variables for which the programmer must 
substitute specific information or spe- 
cific values. 

• Items or groups of items within brack- 
ets, [ ] , are optional; they may be 
omitted at the programmer's discretion. 
Any item or group of items not within 
brackets must be coded. 

• Braces, { } , group related items, one 
of which must be coded. 



PARAMETERS IN THE OPERAND FIELD 

The operand field is made up of two 
types of parameters: positional and key- 
word. A positional parameter is charac- 
terized by its position in the operand in 
relation to other parameters, and must be 
placed first in the operand in a specific 
order . The absence of a positional parame- 
ter is indicated by a comma coded in its 
place. 

A keyword parameter is positionally 
independent with respect to other keyword 



• Stacked items, enclosed in either 
brackets or braces, represent alterna- 
tive items. No more than one of the 
stacked items may be coded by the 
programmer. 

• If an alternative item is underlined, 
that item is implied, that is, the RJE 
system automatically assumes that it is 
the programmer's choice if none of the 
items are coded. 

• An elipsis, ..., indicates that the 
preceding item or group of items can be 
coded more than once in succession. 
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JOB ENTRY DEFINITION STATEMENT 



FUNCTION OF JED STATEMENT 

With the JED statement, the user speci- 
fies how his job entry is handled at the 
central system. The JED statement 
describes job entry processing through a 
combination of optional keyword parameters. 
The choice of these parameters depends upon 
the RJE application. The JED statement is 
not required as part of the job entry. If 
the JED statement is omitted, system 
default options are assumed. These assumed 
options are: 

1 . Immediate output 

2. No notification of job completion 

3. All output returned to the user 

If the JED statement is included but 
contains errors in syntax, the statement is 



rejected, but the job is accepted and is 
processed with the assumed system default 
options. (The descriptions of the keyword 
parameters in Figure 3 include the assump- 
tions made by RJE if the parameters are 
omitted.) 



The operand and comment fields can be 
continued on as many cards as are required 
to define the job entry. A nonblank 
character in column 72 indicates that the 
statement is continued on the next card. A 
continuation card is identified by the 
characters (..) in columns 1 and 2. 
Columns 3 through 15 in the card are blank. 
A continued operand field must begin in 
column 1 6 of the card. A continued comment 
field can begin in any column past column 
15. 



ID | 
4 



Operation 
JED 



Operand (Keyword Parameters) 

|~ OUTPUT=IMMED "I 

|_OUTPUT= (DEFER, us erid)J 

'( SOURCE ) 



,NOTIFY=H V,'text 
A BOTH ) 



",CENTRAL= ({stepname.ddname} , . 
, CENTRAL=ALL 



J. J. 



..,] 



J 



Figure 3. Format of the JED Statement 



OUTPUT — SPECIFYING JOB OUTPUT DISPOSITION 

The OUTPUT keyword parameter allows the 
user to specify job output as immediate or 
deferred . This parameter also allows the 
user submitting the job to specify another 
user as a valid recipient of the output. 
RJE returns immediate job output to the 
originator of the job as soon as it is com- 
pleted. RJE returns deferred job output 
when it is requested on the command of 
valid recipients. RJE returns deferred job 
output only to a user who submitted the job 
or was named as a valid recipient. 

Only one copy of job output is avail- 
able. This copy is returned to the first 
valid recipient requesting it. The remote 
user makes multiple copies of his output 
available to either himself or an alternate 
by writing his output to a named data set 
and submitting a job step which executes a 
utility program (IEBPTPCH) to copy the out- 
put to SYSOUT. The IEBPTPCH program is 



described in the publication IBM System/360 
Operating System Utilities , Form C28-6586. 

If the user omits this keyword in the 
JED statement, the RJE system assumes 
OUTPUT=IMMED. 

r t 1 

| Operation | Operand | 

|. + 1 

j | OUTPUT=IMMED | 

|.. JED | | 

| | OUTPUT= (DEFER [,userid] ) j 

L J J 

OUTPUT=IMMED 

specifies job output as immediate. 
The user receives this output at the 
work station where he is logged on. 
If the user is not logged on when the 
job is complete, RJE sends the output 
to the work station where the user was 
last logged on. If this work station 
is inactive, the output is held until 
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either the work station is logically 
attached or the user logs on at anoth- 
er work station. In addition, if the 
inactive work station is connected via 
a switched line, RJE sends a message 
to the central operator indicating 
that output is available for the work 
station. This message allows the 
central operator to call the work sta- 
tion and inform the operator that 
there is immediate output available. 
Thus, the work station need not main- 
tain connection with the central sys- 
tem when there is no traffic over the 
line. If the work station is con- 
nected via a nonswitched line, no mes- 
sage is sent to the central operator. 

OUTPUT=DEFER 

specifies job output as deferred. The 
user must retrieve this output by com- 
mand. It is sent to the work station 
where the user requests the output. 
Since no alternate is specified, the 
job output can only be requested by 
the user who submitted the job. The 
work station may or may not be the 
work station from which RJE received 
the job. The status of deferred job 
output in the system is available by 
command. 

OUTPUT= (DEFER, user id) 

specifies job output as deferred, and 
specifies that another RJE user, iden- 
tified by the userid, is a valid job 
output recipient. RJE returns this 
output to the user submitting the job 
or to the user named in this subparam- 
eter. If an invalid userid is speci- 
fied, the userid subparameter is 
ignored, and a message indicating the 
error is sent to the user who sub- 
mitted the job. The JED statement is 
processed as though no userid were 
specified. 



NOTIFY — REQUESTING NOTIFICATION OF JOB 
COMPLETION 

The NOTIFY keyword parameter allows the 
user to request notification of job comple- 
tion. In addition, the user may specify up 
to 25 characters of text which RJE returns 
with the notification. The NOTIFY keyword 
parameter is used in conjunction with the 
DEFER subparameter in the OUTPUT keyword 
parameter. Notification includes the job- 
name and the type of job termination — 
normal or abnormal. If the user omits this 
parameter, no notification is sent at job 
completion. If the JED statement includes 
OUTPUT=IMMED, RJE ignores the NOTIFY param- 
eter and continues processing the 
statement. 



r t n 

| Operation | Operand | 

j. + 1 

| j /(SOURCE) 

|.. JED |NOTIFY=(J [ C'text'] 

I | \/both ) 

L X J 



NOTIFY=SOURCE 

indicates that the user originating 
the job desires notification of job 
completion. The procedure for notify- 
ing the user of job completion is the 
same as the procedure for sending 
immediate output, described above in 
OUTPUT=IMMED. 

NOTIFY=BOTH 

specifies that the user originating 
the job desires that both he and an 
alternate recipient be notified at job 
completion. He specifies the alter- 
nate recipient in the OUTPUT parame- 
ter. If an alternate recipient is not 
specified, only the originator 
receives notification. No error mes- 
sage is sent. Procedures for notify- 
ing the user originating the job are 
the same as those for sending immedi- 
ate output, described in OUTPUT=I MMED . 
An alternate recipient receives noti- 
fication only when he is logged on 
after job completion. If the origina- 
tor requests the output before the 
alternate recipient logs on, no noti- 
fication is sent to the alternate. 

NOTIFY= (SOURCE, 'text') 

indicates that the notification at job 
completion is to include the text 
which the user has specified as a sub- 
parameter. The text is limited to 25 
printable characters and blanks, and 
must be framed in apostrophes. If the 
text contains apostrophes, they must 
be paired, and each pair counts as one 
text character. The text subparameter 
contains any information that the user 
considers valuable in the job comple- 
tion notification. 

NOTIFY= (BOTH, 'text') 

specifies that the user originating 
the job desires that both he and an 
alternate recipient, specified in the 
OUTPUT parameter, be notified at job 
completion, and that the notification 
of each user include the information 
specified in the text subparameter. 
Notification of each user takes place 
as described for NOTIFY=BOTH. 



Note : The information specified in the 
text subparameter also is included in the 
response for any ALERT command associated 
with this job (see ALERT) . 
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CENTRAL - WRITING ON THE CENTRAL 
INSTALLATION OUTPUT DEVICES 

The CENTRAL keyword parameter allows the 
user to direct job output data sets to the 
central installation output writers for 
processing. These output writers process 
the output by class in accordance with the 
central installation's usual SYSOUT conven- 
tions. That is, if the user specifies his 
output as class A (SYSOUT=A) , the output is 
written when an output writer is started 
for class A at the central system. The 
user may specify that all output data sets 
created by the job are to be processed 
centrally, or that one or more output data 
sets are to be processed centrally and the 
remaining job output returned to him. Job 
management messages (allocation, dealloca- 
tion, statement errors, etc.) are always 
directed back to the remote user. Once the 
specified output has been given to the 
local output writers for processing, it 
cannot be returned to the user. If the 
user omits the CENTRAL parameter, all out- 
put created by the job is returned to him. 

r t 1 

| Operation | Operand | 

j. + .j 

| | CENTRAL= ( {stepname. ddname} , . . .) | 
|.. JED | | 

j j CENTRAL=ALL | 

L JL J 

CENTRAL=stepname . ddname 

specifies that the output data set, 
created in the step named (stepname) 
and defined by the DD statement named 



(ddname) , is to be processed by the 
central output writers. The output 
data set is processed by an output 
writer according to the class speci- 
fied in the SYSOUT parameter of the DD 
statement. If the indicated DD state- 
ment is not included in the specified 
job step, the JED statement is pro- 
cessed as if no reference to the data 
set were made. An error message is 
returned, however, to the remote work 
station for each data set not found in 
the JCL for the JOB step. 

CENTRAL= (stepname. ddname, . . . , 
stepname. ddname) 
provides a list of output data sets 
which are to be processed by the 
central output writers. Each data set 
specified in the list must be identi- 
fied with the name of the step which 
creates it and the name of the DD 
statement which defines it. The maxi- 
mum number of data sets that can be 
specified in this list is ten. 

CENTRAL=ALL 

specifies that all output data sets 
created by the job are to be processed 
by the central output writers. Job 
management messages are never given to 
the central output writers for proces- 
sing and are always available to the 
user after job completion. 

Programmer's Note : The subparameter list 
of the CENTRAL keyword may be continued on 
as many cards as necessary to complete the 
list, (see example one in Figure 4) . 



Example One 

r 1 

j .. JED OUTPUT= (DEFER, CHC) , +COSINE01 j 
j .. NOTIFY= (BOTH, 'CALL JONES IF NOT PRESENT'), *COSINE02 | 
j .. CENTRAL=(STEP1.STSDS1,STEP2.STSDS2, +COSINE03 j 
| .. STEP3.STSDS3) COSINEOU | 
L J 

Example Two 

r 1 

j .. JED OUTPUT=IMMED, +SORT001 | 

| . . NOTIFY=SOURCE SORT002 | 

L J 

Example Three 

r 1 

j .. JED CENTRAL=ALL,NOTIFY=SOURCE,OUTPUT=DEFER MONLRPT j 

L J 

Example Four (Incorrect) 

r 1 

j .. JED OUTPUT= (ERR, DEFER) , +SQROOT01 j 
| .. NOTIFY= (BOTH, SQUARE ROOT FINISH'D +SQROOT02 | 
j .. CENTRAL= (STEP LOUT PUT 1,STEP2. +SQROOT03 j 
| . . OUTPUT 2) SQROOT04 | 
L J 

Figure 4. JED Statement Examples 
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JED STATEMENT EXAMPLES 

The examples here explained are illus- 
trated in Figure 4 . 

Examp le One 

1. OUTPUT= (DEFER, CHC) specifies job out- 
put as deferred. This output is kept 
until a valid user requests it. It 
also specifies that a user assigned 
the userid CHC is a valid recipient of 
this output. Whoever requests the job 
output first, the originator or CHC, 
receives the only copy of the output. 

2. NOTIFY= (BOTH, 'CALL JONES IF NOT PRE- 
SENT*) specifies that both the origi- 
nator and CHC are to be notified when 
the job completes. The originator 
receives the notification at his work 
station even if he is not logged on. 
CHC receives notification when he is 
logged on. The notification includes 
CALL JONES IF NOT PRESENT. The noti- 
fication is not sent to CHC if the 
output is requested by the originator 
before CHC logs on. 

3 . CENTRAL= (STEP 1 . STSDS 1 , STEP 2 . STSDS 2 , 
STEP3.STSDS3) shows that the user 
desires that three output data sets, 
STSDS 1 created in the first step of 
the job, STSDS 2 created in the second 
step, and STSDS3 created in the third 
step, be processed by the central 
installation output writers. These 
three data sets are not returned to 
the user. 

4. The sequence field, COSINE01, 
COSINE02, or COSINE03, is returned in 
any JED diagnostic message to identify 
the specific card in error. 

Example Two 

1. OUTPUT=IMMED specifies the job output 
as immediate. RJE returns the output 
to the work station where the user is 
or was last logged on. 

2. NOTIFY=SOURCE is ignored by RJE since 
the output is specified as immediate. 
No error message is sent. 

3. All job output is returned to the user 
since the CENTRAL parameter is 
omitted. 



4. The sequence field, SORT0001 or 

SORT0002, is returned in any JED diag- 
nostic message to identify the specif- 
ic card in error. 



Example Three 



1 . CENTRAL=ALL specifies that the central 
output writers process all output data 
sets created by the job according to 
class. These data sets are not avail- 
able to the user. 



NOTIFY=SOURCE specifies that the user 
receives notification of job 
completion. 



3. OUTPUT=DEFER specifies that job output 
is deferred and returned to the user 
upon command. In this example only 
job management messages are available 
since CENTRAL=ALL is specified. 



4. The sequence field MONLRPT is returned 
in any diagnostic message pertaining 
to this statement. 

Example Four 

This JED statement example illustrates 
possible coding errors: 

1 . The OUTPUT subparameters are specified 
in the wrong order. The disposition 
of output must be specified before 
specification of an alternate recipi- 
ent of the output. 

2. The text subparameter in the NOTIFY 
parameter is not framed with apos- 
trophes. Also, the apostrophe con- 
tained within the text is not paired, 
and there is no right-hand parenthesis 
on the NOTIFY parameter. 

3. The second continuation card, 
SQROOT03, is treated as a comment 
since operand field continuation is 
not specified with a trailing comma in 
the preceding card. 

4. On cards SQROOT03 and SQROOT04, a 
stepname.ddname in the CENTRAL keyword 
is specified on separate cards. 
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WORK STATION COMMANDS 



Command statements provide a convenient 
means of requesting RJE system facilities 
for the remote environment. Work station 
commands allow users at the remote work 
stations to communicate with the RJE system 
and request RJE facilities. 

Work station commands are interspersed 
between job entries in the input stream. 
They must not be included within a job 
entry since collection of the job entry 
stops when a JECL statement is encountered. 
Work station commands may also be entered 
from a printer-keyboard if one is available 
at the work station. 

The command statement contains the iden- 
tifying characters (..) in columns 1 and 
2, the command and, in most cases, an 
operand field. In addition, the sequence 
field may be used for statement identifica- 
tion. RJE returns this field with all 
responses and diagnostics pertaining to the 
statement. Any comments appear after the 
operand field, separated from it by at 
least one blank. If the operand field is 
not present, and comments are desired, the 
user codes a comma to indicate that the 
operand field is absent and that the infor- 
mation specified is a comment. The user 
must follow the comma with at least one 
blank before his comment. 

Note : A command statement cannot be con- 
tinued. It must be coded on one card or 
card image. 



FUNCTIONS OF WORK STATIO N COMMANDS 

The commands available to RJE users and 
operators at remote work stations provide a 
number of capabilities. 

1 . Commands used to define the state of 
the work station: 

R J START 
RJEND 
LOGON 
LOGOFF 



4. 



ALERT 

STATUS 

BRDCSTR 

Command used to communicate among RJE 
users: 



MSGR 

A complete description of the work sta- 
tion commands and their operands follows. 
These commands are summarized in Figure 5. 



| ID | Operation j Operand 
f __ + + 



i •• 


R J START | 


termid 


[,BRDCST=NO "I 
,BRDCST=YESj 

[CALL= Integer] 


i •• 


RJEND | 


(no operand) 


i •• 


LOGON | 


userid,key 


i •• 


LOGOFF | 


(no operand) 


i •• 


OUTPUT | 


J= jobname 

U=userid 

* 




i •• 


CONTINUE | 


"begin! 

.NO J 


i •• 


DELETE | 


[jobname] 


i •• 


ALERT | 


jobname 
* 

/ 




i •• 


STATUS | 


~~J=jobname - 
U=userid 
* 

_T 




j.. 


BRDCSTR | 


(no operand) 


i •• 


MSGR | 


M='text' [ 


,u 


=userid] 

[,T=termid] 



Figure 5. Summary of Work Station 
Commands. 



3. 



Commands used to manipulate job 
output: 

OUTPUT 

CONTINUE 

DELETE 

Commands used to provide job and sys- 
tem information: 



RJSTART — ATTACH A WORK STATION TO THE RJE 
SYSTEM 

The RJSTART command logically attaches a 
work station to the RJE system. The 
RJSTART command must be the first statement 
received from an inactive work station (one 
not currently attached to the system) . 
This command identifies the work station to 
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RJE. It also allows the work station to 
request broadcast messages before continu- 
ing RJE processing. Communication proceeds 
between the central system and the work 
station when a valid RJSTART command is 
received. Once the work station is logic- 
ally attached, it can monitor the RJE sys- 
tem for output directed to it, and users 
may gain access to the central system by 
logging on at the work station. If the 
work station has the Auto Call special fea- 
ture installed, the user can give the tele- 
phone number of the central system as a pa- 
rameter. If the user codes this parameter, 
the work station calls the number 
specified. 



RJEND — DETACH A WORK STATION FROM THE RJE 
SYSTEM 

The RJEND command allows an RJE user to 
logically detach his work station from the 
system. When the RJEND command is received 
by the central system, closedown activities 
are initiated for the work station. Close- 
down activities involve transmission of all 
available messages directed to the work 
station. No job output is returned to the 
work station after the RJEND command is 
received. The last message sent to the 
work station indicates that the RJEND com- 
mand was received and that the work station 
is now logically detached from the system. 



r t t 

| Operation | Operand | 

j. + ^ 

I j [, BRDCST=YES1 j 

j.. RJSTART j termid | , BRDCST=NO J | 

I I I 

| | [,CALL=integers] | 

L X . - J 

termid 

specifies the RJE name of the work 
station which is supplied to RJE by 
the installation when the program for 
the central system is assembled. It 
may consist of one to eight alphameric 
(alphabetic and numeric) characters, 
the first of which must be alphabetic. 
If the termid specified is not reco- 
gnized as a valid name, RJE rejects 
the command, and a corrected statement 
must be submitted. 

BRDCST=YES 

specifies that a copy of the broadcast 
messages is desired before the work 
station continues RJE processing. 

BRDCST=NO 

specifies that a copy of the broadcast 
messages is not desired at the work 
station. This option is assumed by 
RJE if the parameter is omitted. 

CALL=integers 

specifies the telephone number of the 
central system which the work station 
is to dial. This parameter is only 
valid if the work station has the Auto 
Call feature installed. The user can 
code a maximum of fifteen digits in 
this parameter. 



If the work station is connected to the 
central system via a switched connection, 
the connection is broken. The operator 
should not take his work station off-line 
before he has received the message indicat- 
ing that the RJEND command was accepted, 
because the central system will note an 
error condition which will have to be 
resolved at the next work station startup. 
No further communication occurs until the 
work station resumes RJE activity with an 
RJSTART command. 



r t 1 

| Operation | Operand | 

| + _ ., 

| . . RJEND | (no operand) | 

L J- . J 



LOGON — BEGIN A SESSION IN RJE 

A user at a work station logically 
attached to the RJE system issues a LOGON 
command to start his session. The command 
identifies the user to RJE and allows him 
access to the system. By checking the 
userid and key specified in the LOGON com- 
mand, RJE guarantees that only valid users 
can submit input or request output from the 
system. The LOGON command remains in 
effect until another LOGON, a LOGOFF, or an 
RJEND command is issued. 



r t 1 

| Operation | Operand | 

j. + .j 

).. LOGON |userid,key | 

L JL . J 



Note ; The RJSTART command must be the 
first statement submitted at an inactive 
work station. If the work station desires 
to resume RJE activity after it has been 
logically detached from the system (after 
an RJEND command or a system failure) , it 
must resubmit the RJSTART command. 



userid 

specifies the RJE name assigned to the 
user by the installation (userid) . If 
the userid specified in this parameter 
is not valid, RJE rejects the command, 
and a corrected statement must be 
submitted. 
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key 

specifies the valid protection key 
assigned with the userid. If the key 
specified in this parameter is not the 
key which was assigned with the 
userid, the LOGON command is rejected. 
The RJE system never prints a protec- 
tion key at a work station. 

Note 1 : Only two statements other than the 
LOGON command may follow the RJSTART com- 
mand: RJEND or CONTINUE. 

Note 2 ; The user id- key pair assignments 
are specified either at RJE assembly time 
or dynamically by the central operator with 
the USERID command. 

Programmer's Note : A user cannot be logged 
on at more than one work station at a time. 
If a user desires to change work stations, 
he must log off at his old work station 
before logging on at the new work station. 
If a user who is logged on at one work sta- 
tion submits a LOGON command at another 
work station, the second LOGON command is 
rejected. 

LOGOFF — END A SESSION 

With the LOGOFF command, the user indi- 
cates that he has completed his session. 
After receiving a LOGOFF command, RJE 
refuses input from the work station until 
another LOGON command is submitted. Howev- 
er, the operator can continue to monitor 
the system for output directed to the work 
station, or he can issue an RJEND command 
to logically detach the station from the 
system. 



j Operation j Operand 

,. + 

| . . LOGOFF | (no operand) 



Note : If the central system receives a 
valid LOGON command from a work station 
with a session in progress, the central 
system logs off the current user and logs 
on the user identified in the LOGON com- 
mand. If the central system receives an 
RJEND command from a work station with a 
session in progress, it logs off the user 
and logically detaches the work station. 

OUTPUT — REQUEST JOB OUTPUT 

Deferred job output is retrieved with 
the OUTPUT command. If the user is a valid 
recipient and output is available, RJE 
returns the output to the user. If the job 
is not complete when its output is 
requested, RJE returns a message indicating 
this. The OUTPUT command must be resub- 
mitted after the job has completed. The 
OUTPUT command provides three capabilities: 



1. The user may request (in a specific 
request) the deferred output of a spe- 
cific job in the system. 

2. The user may request (in a minor re- 
quest) all deferred output created by 
jobs submitted by a specified user and 
naming him as a valid recipient. 

3. The user may request (in a major re- 
quest) all deferred output naming him 
as a valid recipient. 

If the user is not a valid recipient of 
the output, an invalid request response is 
returned. If output of a job that is not 
in the system is requested, notification 
also is returned to the user. 



j Operation | Operand 

J=jobname 
OUTPUT | U=userid 

* 



J=jobname 

indicates that the request is for the 
output of the job named in the parame- 
ter (specific request) . The user 
receives the output if he originated 
the job or is named as a valid recipi- 
ent for the output. 

U=userid 

indicates that the request is for out- 
put from all jobs submitted by the 
named user which designate the re- 
questing user as a valid recipient (a 
minor request) . If the user gives his 
own userid, or omits the operand, he 
receives all available output from 
jobs submitted by him. 



the coded value * (asterisk) , indi- 
cates that the request is for all out- 
put in the system for which the user 
is a valid recipient (a major re- 
quest) . The user receives all avail- 
able deferred output of jobs submitted 
by him and of jobs submitted by other 
users which named him as a valid 
recipient. 

no operand 

if the operand field is left blank, 
RJE returns to the user all the avail- 
able output created by jobs that the 
user, identified in the current LOGON 
command, has submitted. In effect, 
RJE assumes U=userid with the request- 
ing user designated as recipient. 

Note : A user cannot receive job output 
from another user's job unless he is named 
as a valid recipient. A user is automati- 
cally a valid recipient of job output if he 
submits the job. 
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CONTINUE — REQUEST DISCONTINUED JOB OUTPUT 

The user or operator at a work station 
specifies the disposition of discontinued 
output with the CONTINUE command. Output 
may be discontinued under one of the fol- 
lowing conditions: 

1. A forms requirement message, indicat- 
ing a change in the form number speci- 
fied for the output, is sent to the 
work station. 

2. Operator intervention at the work sta- 
tion causes output to be discontinued. 

3. Equipment failure during an output 
operation causes an interruption in 
output . 

When interrupted output is held for a 
work station, no output is returned to the 
work station until a CONTINUE command is 
received. RJE continues to accept input 
from the work station, however. If the 
operator submits an RJEND command, trans- 
mission of the discontinued output data set 
will resume from the point it was discon- 
tinued, when the operator submits his next 
RJSTART command. If the discontinue state 
was the result of a transmission failure, 
the remote work station must first send an 
RJSTART. Any other card will cause the 
message RJSTART REQUIRED to be sent back to 
the remote work station and the discontinue 
state will still exist. Other than this 
response, no output is returned to the work 
station until an RJSTART command is 
received. 



no operand 

specifies that transmission of the 
data set is to be resumed with the 
first record of the SYSOUT block that 
was being written when the output was 
discontinued. With blocked records 
there is a possibility of duplicate 
records since transmission is resumed 
at the beginning of a block rather 
than with a specific record. 

If the interrupted output is a series of 
BRDCST messages, any one of the above three 
types of CONTINUE commands will cause the 
entire series of BRDCST messages to ba 
transmitted from the beginning. 

If the interrupted output is anything 
other than SYSOUT data or BRDCST messages, 
any one of the above three types of CON- 
TINUE commands will resume transmission 
with the line of text that was stopped. 
Attempting to continue JCL, allocation or 
deallocation messages may cause the lcist 
several lines to be repeated. The amount 
of overlap varies from to 5 duplicate 
lines. 

The only time the three types of 
operands on the CONTINUE command have indi- 
vidual effects is when a SYSOUT data set 
wa s di scont inued . 



DELETE — REMOVE A JOB FROM THE RJE SYSTEM 



If the interrupted output is from a SYS- 
OUT data set, the CONTINUE command provides 
three capabilities : 

1 . The user can request the transmission 
of the entire interrupted output data 
set. 

2. The user can specify that transmission 
of the data set be resumed with the 
first record of the SYSOUT block which 
was being written when the output was 
discontinued. 

3. The user can specify that he does not 
desire the output and can direct RJE 
to delete it. 



j Operation | Operand 

|.. CONTINUE | [BEGIN] 
l jL N0 J 






J 



BEGIN 



NO 



specifies that the user desires trans- 
mission of the entire data set. 



indicates that the user desires RJE to 
delete the data set. 



With the DELETE command, the user may 
remove jobs from the RJE system, without 
receiving a copy of the job output. This 
command directs RJE to remove from the sys- 
tem all job output and all references to 
the job. It does not remove named data 
sets created by the job or output datci sets 
directed to the central installation. The 
DELETE command is not necessary to remove 
job output which already has been returned 
to the user. All references to the job in 
the RJE system are normally removed after 
the job output is returned to the user. A 
job can only be deleted if it is on the 
input queue, is executing, or has been 
deferred and has not been called for by an 
OUTPUT command. The DELETE command pro- 
vides two capabilities: 

1 . The user can delete a specific job 
previously submitted by him. 

2. The user can delete all jobs previous- 
ly submitted by him. 



Note : The job is not deleted from th«; sys- 
tem until the message "IHK007I JOB DELETED 
jobname userid" is issued. No job with the 
same jobname can be entered until this mes- 
sage is received. 
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j Operation j Operand 
j.. DELETE 1 1 [jobname] 



—\ 



jobname 

specifies the name of the job that the 
user desires to remove from the sys- 
tem. The command is rejected if the 
user requesting the removal is not the 
user who originated the job. 



no operand 

specifies that all jobs currently in 
the system submitted under the userid 
in the current LOGON command are to be 
removed from the system. This format 
is useful for avoiding duplicate job- 
names by clearing the system of for- 
gotten jobs. Caution must be exer- 
cised when using this optional format. 
A user should not use this format if 
he is sharing a userid since it 
deletes all jobs submitted under the 
userid. 
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ALERT — REQUEST NOTIFICATION OF 
AVAILABILITY OF DEFERRED OUTPUT 

The user issues the ALERT command if he 
wants to be alerted when deferred job out- 
put becomes available for him. The user 
may request to be alerted: 



1 . When the output of a specific job is 
available (specific alert) ; 

2. When output from any job submitted by 
him is available (minor alert) ; 

3. When any output for which he is a 
valid recipient is available (major 
alert) . 



j Operation! Operand 
I- +: 



ALERT 




._J 



jobname 

identifies a particular job for which 
the user desires to be alerted. If 
the job addressed is in the system but 
not complete, the request remains 
pending in the system until the job is 
completed. If the job requested is 
not in the system, a message indicat- 
ing this fact is returned, and the 
command is rejected. 



the coded value * (asterisk) is used 
if the user wants to be alerted when 
any job output is available for him. 
It is especially useful if the user 
expects job output from other users 
who have specified him as an alternate 
recipient. The ALERT * remains pend- 
ing in the system under the conditions 
previously described. 



the coded value / (slash) indicates 
that the user desires to cancel all 
ALERT commands previously issued by 
him. All impending ALERT commands 
issued by the user are cancelled when 
RJE receives the ALERT / command. 
There is no selective cancelling of 
ALERT commands. 

no operand 

if the operand field is left blank, 
RJE alerts the user when any job that 
he has submitted has output available. 
The command remains pending in the 
system under the conditions previously 
described. 



Note : The user receives only one alert 
response for each job regardless of the 
number of ALERT commands issued by the user 
(except for specific alert for which he 
will be notified each time it is sub- 
mitted) . For example, if the user issues 
an ALERT * and is alerted that two jobs 
have output available for him, no addition- 
al alerts for those two jobs are returned, 
regardless of the number of subsequent 
ALERT commands issued by the user. Infor- 
mation about the jobs, however, is always 
available with the STATUS command. 

The immediate response to the command 
indicates all currently available output of 
the job, or jobs, involved. If the command 
involves any job in the system not current- 
ly available, the command waits in the sys- 
tem and returns additional responses as job 
output becomes available. If the command 
specifies a job that is not in the system, 
a message indicating that no such job 
exists is returned to the work station and 
the command is cancelled. 

The response to the ALERT command con- 
tains the information necessary to retrieve 
the output with the OUTPUT command. It 
also includes any user information speci- 
fied in the JED NOTIFY parameter. A valid 
ALERT command remains waiting in the system 
until: 

1 . It is cancelled with an ALERT / com- 
mand issued by that user, 

2. An RJEND command is issued at the work 
station, or until 

3. The ALERT command response for a job, 
specified by jobname in the operand, 
is sent. 

Alert command responses are sent to the 
work station associated with the user who 
submitted the command, that is, the work 
station where that user is or last was 
logged on. If the work station is logical- 
ly attached to the system, the response is 
sent regardless of who is logged on or 
whether or not anyone is logged on. 



STATUS — DETERMINE THE STATUS OF A JOB 

The STATUS command allows a user to 
determine the status of one or more remote- 
ly submitted jobs. RJE returns the status 
of only those jobs addressed by this com- 
mand which are currently in the system and 
for which the requester is a valid recipi- 
ent. The STATUS command provides the fol- 
lowing capabilities: 

1 . The user can request the status of a 
specific job (a specific request) . 
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2. The user can request the status of 
jobs submitted by a particular user 
for which he is a valid recipient (a 
minor request) . 

3. The user can request the status of all 
jobs in the system for which he is a 
valid recipient (a major request) . 

4. The user can request the status of all 
jobs that are currently associated 
with the work station (a terminal 
request) . 

The user receives a response for each 
job that satisfies the command. Each 
response contains the jobname and an indi- 
cation of its status: 

1 . Scheduled (with queue position) 

2. Executing 

3. Complete (normal or abnormal 
termination) 

In addition to these responses, if the com- 
mand addresses a specific job, one of two 
responses may be returned: 

4. Not in the system 

5. Invalid request (the user is not a 
valid recipient) 

The STATUS command does not wait in the 
RJE system. RJE returns the status of only 
those jobs in the system at the time the 
command is received. It does not automati- 
cally return the new status of a job when a 
change of status occurs. The user, howev- 
er, may request notification of job comple- 
tion with the ALERT command. 



r T 

| Operation | Operand 

h + _ . 

J= jobname 



STATUS 



U=userid 
* 

T 



J=jobname 

indicates that the request is for the 
status of a specific job identified by 
the jobname. If the user issuing the 
command is not a valid recipient of 
the job, or if this job is not in the 
system, the status request is denied. 
A message is returned to the user 
indicating the reason. 

U=userid 

indicates that the request is for the 
status of all current jobs submitted 
by the user identified with the userid 
for which the requesting user is a 



valid recipient. If the user speci- 
fies his own userid or omits the 
operand, he receives the status of 
only his own jobs currently in the 
system. 



the coded value * (asterisk) indicates 
that the user desires the status of 
all jobs currently in the system for 
which he is a valid recipient. 



the coded value T is used to receive 
the status of all jobs in the system 
currently associated with the work 
station. A job is associated with a 
work station if the user who submitted 
the job is or last was logged on at 
the work station. This format is use- 
ful just before the work station 
initiates closedown. 

no operand 

RJE assumes that the user issuing the 
command desires the status of all jobs 
submitted by him. In effect, it 
assumes U=userid with the requesting 
user designated. 

Note : When a user requests the status of a 
job submitted to and acknowledged by the 
RJE system, and the status response speci- 
fies that the job is not in the system, one 
of the following conditions has occurred: 

1 . If the output was specified as immedi- 
ate, the output has already been 
returned to the work station asso- 
ciated with the job. 

2. If the output was specified as 
deferred and an alternate recipient 
was specified, the alternate has 
retrieved the copy of job output with 
an OUTPUT command. 

3. If the userid is shared, another indi- 
vidual sharing the userid may have - 
received the output. 

4. The job was deleted by the user or by 
another user sharing his userid. 



BRDCSTR 



REQUEST THE BROADCAST MESSAGES 



The remote user requests a copy of the 
broadcast messages with the BRDCSTR com- 
mand. RJE responds to this command by 
returning a copy of the system broadcctst 
messages to the work station. These mes- 
sages contain information of general inter- 
est to the entire RJE system. They may 
include any information considered desir- 
able by the installation and are sent only 
on request from a work station. The infor- 
mation might include: 
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1. The next scheduled RJE closedown at 
the central system and the various 
work stations. 



2. The next scheduled RJE startup at the 
central system and various work 
stations . 



3. The installation equipment configura- 
tion and its status at the central 
system and various work stations. 



The broadcast messages are created and 
maintained by the central operator. 



j Operation j Operand j 

MSGR |M= , text' [,U=userid] [ r T=termid] | 



j Operation j Operand j 

j . . BRDCSTR | (no operand) j 



MSGR — COMMUNICATE WITHIN RJE 

The RJE user sends messages to other 
points in the RJE system with the MSGR com- 
mand. Messages may be sent to the central 
operator, to work stations attached to the 
RJE system, and to RJE users. Messages 
sent to the central operator are displayed 
on his printer-keyboard when they are 
received. Messages are sent to a work sta- 
tion if it is logically attached to the 
system. If the work station is not active 
when RJE receives the command, the message 
is kept in the system until it can be 
delivered. This facility allows the user 
to "leave word" if a work station is inac- 
tive when the command is received. RJE 
informs the sender of whether or not the 
message has been sent. Messages directed 
to RJE users are sent only to the work sta- 
tion where the user is currently logged on. 
If the user is not logged on, the command 
is rejected, and a response informs the 
sender. 



If the user specifies that a message is 
to be sent to both a user and a work sta- 
tion, RJE first tries to send the message 
to the specified user. If the user is not 
currently logged on, the message is sent to 
the specified work station or remains in 
the system until it can be sent to the work 
station. 



Message text is limited to 40 charac- 
ters. The MSGR command cannot be con- 
tinued. Any messages requiring more than 
40 characters of text must be sent by mul- 
tiple commands. 



M='text" 

specifies the message text to be sent. 
The message text must be framed by 
apostrophes. The text itself may 
include as many as 40 printable 
characters and blanks. Apostrophes 
contained within the message text must 
be paired; each pair counts as one 
text character. If the U and T key- 
word parameters are omitted, the mes- 
sage is sent to the central operator. 



U=userid 

indicates that the message is to be 
sent to the user specified by the 
user id. The message is sent to the 
work station where the specified user 
is logged on. If he is not currently 
logged on and the T keyword parameter 
is not included, or if the userid is 
not valid, the command is rejected and 
a response is returned to the sender. 
If the user specifies his own userid, 
when RJE receives the command it sends 
the message to the work station where 
he is logged on. This format is use- 
ful if the user desires to have a mes- 
sage returned to the work station when 
his input is being sent to the central 
system. To do this the user places 
the MSGR command, with the desired 
message, after his LOGON command. 



T=termid 

indicates that the message is to be 
sent to the work station specified by 
termid. If the message cannot be sent 
after it is received by the central 
system, it is kept until it can be 
delivered. If no space is available 
in the data set reserved for deferred 
messages, or if the termid specified 
does not correspond to a work station 
in the RJE system, the command is 
rejected, and a response is returned 
to the sender. The message is for- 
matted for the central operator or 
another work station as follows: 



*C* 
RJE MSG userid.! FR userid 2 text 

*C* - message by default goes to central 

userid., - the U option is used 

userid 2 - submitter 
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WORK STATION COMMAND EXAMPLES 



sequence information is returned since this 
field is omitted. 



Example One 

r t 1 

| Operation | Operand | 

|.. R JSTART | NEWYORK5 | 



The work station named NEWY0RK5 is logical- 
ly connected to the RJE system as an active 
work station. Broadcast messages are not 
sent to the work station since they are not 
requested. The sequence field is not 
specified and, as a result, does not accom- 
pany the response to this command. 

Example Two 



j Operation | Operand | Sequence j 

LOGON |PPJ,72C|PPJ70710 | 

x j , -_J 




Example Five 

| Operation j Operand 

|.. ALERT |* 



The user is alerted when any output in the 
RJE system is available for him. This com- 
mand waits in the system until an ALERT / 
or RJEND command is received from the work 
station. No sequence information is 
returned since this field is omitted. 

Example Six 



j Operation j Operand 
|.. STATUS | J=PPJSINFN 






If userid PPJ and key 72C are valid, user 
PPJ is logged on and may begin RJE proces- 
sing. The sequence field PPJ70710 is 
returned with the response to this command. 



Example Three 



j Operation j Operand j Sequence 
, + ±. 



OUTPUT | 



PPJ0020 



I 

I 
J 



The user submitting the command receives 
all available deferred output from jobs 
submitted by him, or he receives a message 
indicating that there is no such output 
available. 



The status of job PPJSINFN is returned to 
the user. No sequence information is 
returned with the response. 

Example Seven 

j Operation j Operand 

, + _ 

j.. MSGR |M= , MOUNT VOL=555555 on 292* 



The message MOUNT VOL=555555 ON 292 is sent 
to the central operator. The response to 
this command indicates whether or not the 
message was delivered. No sequence infor- 
mation is returned since this field is 
omitted. 



The sequence field is returned with the 
response to identify the command addressed. 

Example Four 



j Operation j Operand 
I . . CONTINUE I NO 



1 

I 

J 



The transmission of a discontinued data set 
is not resumed. The data set is deleted, 
that is, removed from the system. No 



Example Eight 

I T 1 

| | Operation | Comment | 

|.. LOGOFF | USE THIS TO END SESSION | 



When RJE receives this command, the user of 
| the current session is logged off. The 
comment contains information the user finds 
helpful in identifying the purpose and 
placement of the command. 
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MESSAGES SENT TO WORK STATIONS 



| IHK100I RJSTART ACCEPTED ssssssss 

Explanation ; A valid RJSTART 
command with sequence number 
(ssssssss) has been received from 
this work station. 

System Action : The work station 
is logically attached to the 
system and placed in the active 
state. Before the RJSTART command 
is acknowledged, the central 
system sends any messages awaiting 
work station startup and any 
discontinued output. The central 
system is prepared to accept a 
LOGON command, a CONTINUE command, 
an RJEND command, or a request to 
discontinue output from the work 
station. 



(userid) , has been received and 
accepted. 

System Action ; The user's session 
is terminated, and the work 
station reverts to the active 
state. The system accepts only 
those commands which may follow an 
RJSTART command, that is, LOGON, 
CONTINUE, or RJEND. 



User Response : 
IHK000I. 



Same as to message 



| IHK103I RJEND ACCEPTED ssssssss 

Explanation : An RJEND command 
with sequence number (ssssssss) 
has been received from this work 
station. 



User Response : If a user desires 
access to the central system, he 
submits a LOGON command. If no 
user desires access to the system, 
the operator may wait for 
immediate job output and messages 
directed to the work station. The 
operator enters the RJEND command 
to terminate RJE activity at the 
work station. 



| IHK101I USER LOGGED ON userid ssssssss 

Explanation : The LOGON command 
with sequence number (ssssssss) , 
submitted by the user assigned the 
specified userid, has been 
received and accepted. 

System Action : Before the LOGON 
command is acknowledged, any 
notify messages waiting for this 
LOGON are returned. The work 
station is placed in the 
processing state giving the user 
access to the central system. 

User Response : The user may 
submit jobs for execution in the 
central system and work station 
commands requesting job output, 
message transmission, or job 
information. 



IHK102I USER LOGGED OFF userid ssssssss 

Explanation : The LOGOFF command 
with sequence number (ssssssss) , 
submitted by the designated user 



System Action : All messages 
currently available for the work 
station are sent before the work 
station is logically detached from 
the RJE system and placed in the 
inactive state. If the work 
station is connected via a 
switched line, the connection is 
broken. 

User Response : None. 



| IHK104I NO JOB (S) IN SYSTEM operation 

jobname userid ssssssss 

userid 

blank 

termid 

Explanation : The central system 
contains no job that meets the 
specifications of the designated 
command (operation) with sequence 
number (ssssssss) . The command 
addresses: 

jobname userid - A specific job 
for user (userid) . 

userid - All jobs submitted by the 
specified user, for which the 
requesting user is a valid 
recipient. 

blank - All jobs in the system for 
which the requesting user is a 
valid recipient. 

termid - All jobs to be returned 
to the specified work station. 
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| IHK105I 



| IHK106I 



| IHK107I 



System Action : The system takes 
no further action unless the 
command is a major or minor ALERT. 
These commands remain in the 
system until cancelled, and a 
message is sent when any job 
satisfying these requests is 
completed. 

User Response : If a jbbname is 
specified the user should ensure 
that it is correct. 



JOB(S) NOT COMPLETE (jobnarae) 
userid ssssssss 

Explanation : The job (jobname) 
that is specified in an OUTPUT or 
ALERT command with sequence number 
(ssssssss) submitted by the user 
(userid) , is in the central system 
but not complete. If the jobname 
is omitted, an ALERT command was 
processed for which there were no 
completed jobs in the system about 
which the user had not been 
previously notified. 

System Action : If an ALERT 
command has been submitted the 
user receives notification when 
the job is completed. 

User Response : If job output was 
requested, the OUTPUT command must 
be resubmitted after the job is 
completed. 



INVALID RECIPIENT jobname userid 
ssssssss 

Explanation : An OUTPUT, ALERT, 
STATUS, or DELETE command with 
sequence number (ssssssss) has 
been submitted by a user (userid) 
who is not a valid recipient of 
the specified job (jobname) ; or in 
the case of DELETE, the command 
was submitted by a user who did 
not submit the job. 



System Action : 
ignored. 



The request is 



User Response : None, 



JOB DELETED jobname userid 
ssssssss 

Explanation : The job (jobname) 
specified in a DELETE command with 
sequence number (ssssssss) 
submitted by the designated user 
(userid) has been deleted. If the 
DELETE command specifies all jobs 



submitted by this user, a separate 
message is returned for each job 
deleted. A job with the same: 
jobname cannot be entered until 
this message is received. 

Note : This message is also issued 
when RJE cancels a job. 

System Action : All references to 
the job and all output from the 
job are removed from the system. 

User Response : None. 



I IHK108I STATUS jobname userid* userid. 2 



SCHED (n) 

EXECUTING ssssssss 
NORMAL END 
ABNORM END 
^DISK ERROR 



Explanation : This is the response 
to the STATUS command with 
sequence number (ssssssss) . The 
response provides the status of 
the job (jobname) submitted by a 
user (userid*) and naming another 
user (userid 2 ) as an alternate 
recipient. 

SCHED (n) - The job is scheduled 
as the nth job on the 
SYS1.SYSJ0BQE. 

EXECUTING - The job is executing. 

NORMAL END - The job has completed 

normally. 

ABNORM END - The job has completed 

abnormally. 

DISK ERROR - The job entry could 

not be read on SYS1 .SYSJOBQE. 

System Action : A response is 
returned for each job in the 
central system which satisfies the 
request. 

User Response : A DISK ERROR job 
must be deleted and resubmitted. 
For other messages no response is 
required. 



| IHK109I NOTIFY jobname userid (text/DISK 
ERROR) 

Explanation : Job (jobname) has 
completed normally with deferred 
output. The user (userid) , edther 
the originator or an alternate 
recipient, has requested 
notification either by specifying 
NOTIFY in the JED statement or by 
submitting an ALERT command which 
addresses the job. Text is any 
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information coded by the 
originator in the JED NOTIFY 
parameter. Text is replaced by 
DISK ERROR when the information 
for the notify message cannot be 
read. 

System Action ; None. 

User Response ; The user may 
request the job output, either 
when notified or later, or he may 
delete it. 

| IHK110I ABEND NOTIFY jobname user id [text] 

Explanation ; This is the same as 
message IHK009I except that the 
job has completed abnormally. 



| IHK111I MSG PENDING STARTUP termid 
ssssssss 

Explanation ; The message text 
specified in a MSGR command with 
sequence number (ssssssss) has not 
been sent because the work station 
(termid) to which it was directed 
is inactive; and if the message 
is directed to either a user or a 
work station, the user is not 
logged on. The message is sent to 
the specified work station when 
the station submits an RJSTART 
command. 

S ystem Action ; The message is 
held at the central system until 
either the work station initiates 
startup procedures, or the central 
operator deletes the message. 

User Response ; None. 



IHK112I MSG QUEUED FOR DELIVERY fuserid ^ 
ssssssss | termid > 

(central) 

Explanation ; The message text 
specified in a MSGR command with 
sequence number (ssssssss) is 
waiting for delivery to; 

userid - the specified user 

termid - the specified work 

station 

CENTRAL - the central operator 

System Action ; The message is 
transmitted to the work station as 
soon as the work station accepts 
it, or it is displayed on the 
printer-keyboard at the central 
system for the central operator. 

User Response ; None. 



I IHK113I 



MSG IGNORED userid f INVALID \ 
ssssssss termid [DISK ERROR! 

Explanation ; The MSGR command 
with sequence number (ssssssss) 
cannot be serviced. The intended 
destination i s ; 

userid - A user who is not logged 
on. 

termid - An inactive work station, 
and no space is available to keep 
the message in the central system. 

INVALID - If INVALID is included 
in the response, the message is 
directed to a userid or termid 
which is not assigned in the RJE 
system. 

DISK ERROR - The message could not 
be held on the message-pending 
data set for the terminal. 



System Action ; 
ignored. 



The command is 



User Response ; The sender may 
resubmit the command later, or he 
may specify the user ' s work 
station if the message was 
directed only to a user. 

| IHK114I MAX JOBS EXCEEDED jobname 

Explanation ; The job entry 
(jobname) cannot be accepted 
because the central system is 
already maintaining its specified 
maximum number of jobs. 

System Action ; The job is 
rejected. A message indicating 
the overload condition is sent to 
the central operator. 

User Response ; The user may 
alleviate this condition by 
requesting or deleting deferred 
job output. If the condition 
persists, the user may ask to have 
the central system reassembled to 
support more remote jobs. The job 
refused must be resubmitted . 

| IHK115I ALERTS CANCELLED userid SSSSSSSS 

Explanation ; An ALERT command 
with sequence number (ssssssss) 
requesting that all pending alerts 
for user (userid) be cancelled has 
been received and accepted. 

System Action ; All pending alerts 
for user (userid) are cancelled. 

User Response ; None. 
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IHK116I RJE CLOSED DOWN 



Explanation : The central operator 
has entered a STOP RJE command and 
is closing down the RJE system. 



the user must delete the job and 
resubmit the job entry with a 
corrected JED statement. If a 
disk error occurred the job must 
be deleted and resubmitted. 



System Action : Closedown 
procedures are initiated at the 
central system for all work 
stations not already inactive when 
the STOP command was issued. Al l 
RJE work stations are placed in 
the inactive state. 

User Response : None. 



IHK117I JOB ACCEPTED jobname userid 
jfsCHED (n) ) (JED j 

i executing [ (default) 
(disk error) 

Explanation : This is a job 
receipt acknowledgement message 
indicating that the job (jobname) 
submitted by user (userid) is 
accepted for execution at the 
central system. 

as the nth job on the 
SYS1.SYSJ0BQE. 

EXECUTING - The job is being 
executed. 

JED - A correctly specified JED 
statement was part of the job 
entry. The job is handled with 
those options which are exercised 
in the JED statement. 

DEFAULT - The JED either was not 
part of the job entry or was 
incorrectly specified. As a 
result, the job is handled with 
the assumed system default 
options . 

DISK ERROR - The job entry could 
not be read on the SYS 1 . SYS JOBQE . 

Note : This message format may not 
apply if your installation alters 
the acknowledge message. Any 
information added to the 
acknowledgement immediately 
follows this message. 

System Action : The system waits 
for job completion to determine 
disposition of job output. 

User Response : If JED options are 
desired but an error has caused 
the JED statement to be ignored. 



IHK118I ALTERNATE IGNORED JED ssssssss; 



Explanation : An alternate 
recipient is specified in the JED 
OUTPUT keyword, but either 
immediate output is specified (in 
which case, no userid may be 
coded) , or an invalid userid is 
coded as an alternate recipient. 
The sequence number of the JED 
card was ssssssss. 



System Action : This error is 
ignored, and JED statement 
processing continues as if no 
userid were specified in the 
OUTPUT keyword. 

User Response : The JED statement 
must be corrected and the job 
entry resubmitted if output is to 
be made available to an alternate . 
be deleted before the correcte d 
job entry is sent to the central 
system . 



I IHK119I 



JOB WAITING DELIVERY jobname 
userid ssssssss 

Explanation : An OUTPUT or DELETE 
command with sequence number 
(ssssssss) , which addresses the 
specified job (jobname) , cannot be 
serviced because the job is 
already waiting for transmission. 



System Action : 
rejected. 



The command is 



User Response : None. 



IHK120I BROADCAST MESSAGES 



FOLLOW 
END 



Explanaqion : This message (with 
the word FOLLOW) is sent 
immediately before the first 
broadcast message and (with the 
word END) after the last broadcast 
message. 

System Action : None. 

User Response : None. 
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| IHK123I DISCONTINUED-CHANGE FORMS TO xxxx | IHK142I INVALID TERMID operation ssssssss 



Explanation : The next output data 
set requires form number xxxx. 
The data set has been 
di scont inued . 



System Action ; 
discontinued. 



The data set is 



Explanation : The designated 
command (operation) with sequence 
number (ssssssss) specifies a 
termid that is not assigned to a 
work station in the RJE system, or 
a termid which is currently being 
used on another line. 



User Response : The user inserts 
the proper form and submits a 
CONTINUE command. 



| IHK139I BLOCK SIZE 400 LIMIT EXCEEDED 
jobname ddname 

Explanation : The problem program 
has created a sysout data set with 
a block size exceeding 400 bytes. 
The sysout class was specified as 
being the user exit at a remote 
CPU. 



System Action : 
rejected. 



The command is 



System Action : 
scratched. 



The data set is 



User Response : (a) Block size in 
the output DCB should be 
respecified to stay within the 
limit, or (b) the sysout class 
should be changed to specify 
printed or punched output. After 
one of the above changes is made, 
resubmit the job. 



I IHK140I INVALID USERID operation ssssssss 

Explanation : The designated 
command (operation) with sequence 
number (ssssssss) specifies a 
userid that is not assigned to a 
user in the RJE system. 



User Response : The user corrects 
the termid and resubmits the 
command. 



I IHK143I INVALID JOBNAME operation ssssssss 

Explanation : The designated 
statement (operation) with 
sequence number (ssssssss) either 
fails to specify a jobname or 
specifies a jobname greater than 
eight characters. 

System Action : The statement is 
rejected. If it is a JOB card, 
the job is rejected. 

User Response : The user corrects 
the jobname and resubmits the card 
or command. 



IHK144I DUPLICATE JOBNAME jobname ssssssss 

Explanation : The JOB card with 
sequence number (ssssssss) 
contains a jobname which is 
identical to one already in the 
RJE system. 



System Action : 
refused. 



The command is 



User Response : The user corrects 
the userid and resubmits the 
command. 



System Action : 
refused. 



The job is 



User Response : The user changes 
the name of the job to a unique 
name and resubmits it. 



| IHK141I INVALID PROTECTION KEY LOGON 
ssssssss 

Explanation : A LOGON command with 
sequence number (ssssssss) 
specifies a protection key that is 
not assigned with the coded 
userid. 

System Action : The LOGON command 
is rejected. 

User Response : The user corrects 
the key and resubmits. 



| IHK145I NO JOB CARD 



Explanation : A job was submitted 
without a JOB card, or the JOB 
card did not follow directly after 
a JED card. 

System Action : If JCL is not 
preceded by a JOB card, the job is 
flushed. If there is no JOB card 
following a JED card, the JED card 
is ignored, and the job is 
processed under the default 
options . 
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IHK146I 



| IHK147I 



IHK148I 



User Response : If the JOB card is 
missing, the user inserts it and 
resubmits the job. If the JED 
card was not followed by the JOB 
card, the card order must be 
corrected and the job resubmitted. 
The job residing in the central 
system as a result of the error 
must be deleted before the job 
entry is resubmitted. 



INVALID KEYWORD VALUE [JED] 
operation ssssssss 

Explanation : An invalid value is 
specified for a keyword in the 
statement (operation) with 
sequence number (ssssssss) . 

System Action : The statement is 
ignored. If the error is in a JED 
statement, the job entry is 
processed with the assumed system 
default options. 

User Response : If the statement 
is a command, the user corrects 
the error and resubmits the 
statement. In the case of a JED 
statement, if assumed options are 
not acceptable for job entry 
processing, he deletes the job. 
The job entry must be resubmitted 
with the corrected JED statement. 
The job residing in the central 
system as a result of the error 
must be deleted before the job 
entry is resubmitted . 



REQD PARAMETER MISSING operation 
ssssssss 

Explanation : A required parameter 
in the operand field is missing or 
invalid in the subject statement 

(operation) with sequence number 

(ssssssss) . 



System Action : 
ignored. 



The statement is 



User Response : The user examines 
the statement in error, supplies 
the missing parameter, and 
resubmits it. 



ILLEGAL DELIMITER operation 
ssssssss 

Explanation : A parameter in the 
operand field of the statement 
(operation) with sequence number 
(ssssssss) is not delimited by a 
comma or, if it was the last 



| IHK149I 



| IHK150I 



parameter, a blank; or an 
apostrophe is missing on a MSGR 
command. 

System Action : The statement is 
ignored. If the error is in a JED 
statement, the job entry is 
processed with the assumed system 
default options. 



User Response : If the statement 
is a command, the user corrects 
the error and resubmits the 
statement. If assumed options are 
not acceptable for job entry 
processing, he deletes the job. 
The job entry must be resubmitted 
with the corrected JED statement. 
The job residing in the centra l 
system as a result of the erro r 
must be deleted before the jot ) 
entry is resubmitted . 



ILLEGAL CONTINUATION operation 
ssssssss 

Explanation : The statement 
(operation) with sequence number 
(ssssssss) which should not hcive 

been continued was continued, or a 

JED statement was improperly 

continued . 

System Action : The statement is 
ignored. If the error is in a JED 
statement, the job entry is 
processed with the assumed system 
default options. 

User Response : If the statement 
is a command, the user corrects 
the error and resubmits the 
statement. If assumed options are 
not acceptable for job entry 
processing, he deletes the job. 
The job entry must be resubmitted 
with the corrected JED statement. 
The job residing in the centra l 
system as a result of the erro r 
must be deleted before the job 
entry is resubmitted . 



UNDEFINED KEYWORD operation 
ssssssss 

Explanation : An undefined keyword 
is specified in the statement 
(operation) with the sequence 
number (ssssssss) . 

System Action : The statement is 
ignored. If the error is in a JED 
statement, the job entry is 
processed with the assumed system 
default options. 
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User Response : If the statement 
is a command, the user corrects 
the error and resubmits the 
statement. If assumed options are 
not acceptable for job entry 
processing, he deletes the job. 
The job entry must be resubmitted 
with the corrected JED statement. 
The job residing in the central 
system as a result of the error 
must be deleted before the job 
entry is resubmitted . 



MULTIPLE USE OF KEYWORD operation 
ssssssss 

Explanation ; A keyword is 
repeated in the statement 

(operation) with sequence number 

(ssssssss) . 

System Action ; The statement is 
ignored. 

User Response : Correct the error 
and resubmit the command. 



in the Job Control Language for 
the job. 

System Action : None. 

User Response : Check the JED 
statement and the JCL. If either 
is in error, correct and resubmit 
the job. 



| IHK154I NO AVAILABLE OUTPUT userid 
ssssssss 

Explanation : This message appears 
at the remote terminal when no 
output is found in the system to 
satisfy the major, minor, or 
default OUTPUT request. To 
satisfy the request, any requested 
job that is found must be: 

1. complete. 



2. not already enqueued for 
source or alternate, and 



IHK152I UNDEFINED OPERATION operation 
ssssssss 

Explanation : The statement 
(operation) with sequence number 
(ssssssss) specifies an undefined 
operation or indicates that there 
is no blank between the . . and 
the operation. The first 8 
characters of the operation field 
are returned. 



IHK155I 



3. one for which the requester 
is a valid recipient. 

System Action : The statement is 
ignored. 

User Response : None. 



INCORRECT TEXT LENGTH operation 
ssssssss 



IHK153I 



System Action : The statement is 
ignored. If the error is in an 
intended JED statement, the job 
entry is processed with the 
assumed system default options. 

User Response : If the statement 
is an intended command, the user 
corrects the error and resubmits. 
If assumed options are not 
acceptable for job entry 
processing, he deletes the job. 
The job entry must be resubmitted 
with the corrected JED statement. 
The job residing in the central 
system as a result of the error 
must be deleted before the job 
entry is resubmitted . 



CENTRAL DATA SET MISSING jobname 
step ddname 

Explanation : The DD statement 
specified in the CENTRAL parameter 
of the JED card could not be found 



Explanation ; The text specified 
in the statement (operation) with 
sequence number (ssssssss) exceeds 
the length allowed. 



System Action : The statement is 
ignored. If the error is in a JED 
statement, the job entry is 
processed with the assumed system 
default options. 



User Response : If the statement 
is a command, the user corrects 
the error and resubmits. In the 
case of the JED statement, if 
assumed options are not acceptable 
for job entry processing, he 
deletes the job. The job entry 
must be resubmitted with the 
corrected JED statement. The job 
residing in the central system as 
a result of the error must be 
deleted before the job entry is 
resubmitted. 
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Explanation ; Input other than an 
RJSTART command has been received 
from a work station that is in the 
inactive state. The work station 
is logically detached from the 
system because either an error 
condition caused the central 
system to detach it or an RJEND 
command was received. 



System Action : 
rejected. 



The input is 



User Response ; The user submits a 
valid RJSTART to begin or resume 
RJE operation at the work station. 



discontinued. This message is 
returned when the next RJSTART 
command is received from the work 
station. 

User Response ; All input 
transmitted to the central system 
which has not been acknowledged 
must be resubmitted. 

| IHK160I ABNORMAL CENTRAL CLOSEDOWN 

Explanation ; A system failure 
requiring restart procedures at 
the work station has occurred at 
the central installation. This 
message is returned when the next 
RJSTART command is received from 
the work station. 



IHK157A LOGON REQUIRED 



IHK158A 



Explanation ; Input other than a 
CONTINUE, RJEND, or LOGON command 
has been received from an active 
work station. 



System Action : 
rejected. 



The input is 



User Response ; If the user has 
input for transmission to the 
central system, he must submit a 
valid LOGON command. 

LOGON REJECTED user id termid 
ssssssss 

Explanation ; A LOGON command with 
sequence number (ssssssss) has 
been submitted by a user (userid) 
already logged on at another work 
station (termid) . A user can be 
logged on at only one work station 
at a time . 

System Action ; The command is 
ignored. If another user is 
logged on at the second work 
station, from which this command 
is received, he remains logged on. 

User Response : The user must log 
off at the initially indicated 
work station (termid) before 
resubmitting the command. 



IHK159I LINE ERROR 



Explanation ; An irrecoverable 
transmission error has occurred on 
an input or output operation. 

System Action : The work station 
is logically detached from the 
system. If an output operation is 
in progress, the output is 



System Action : The system resumes 
normal operation. 

User Response : All input 
transmitted to the central system 
which has not been acknowledged 
must be resubmitted. 

| IHK161I OUT OF SPACE f SYSIN jobname ) 

j SYS 1. SYS JOBQE J 
I jobname ddnamel 

Explanation ; An out of space 
(overload) condition exists in the 
central system. Either all direct 
access storage space allocated for 
the resource SYSIN (SYSIN 
jobname) , or SYS 1 . SYS JOBQE is 
currently in use, or if jobname 
ddname appears, core was not 
available for the SYSOUT buffer 
area. 

System Action ; The central 
operator is informed of the 
overload condition. Until space 
becomes available, all input 
requiring the depleted resource is 
rejected. If jobname ddname is 
specified, processing of the job 
continues as if an end-of-file 
were reached on the data set. The 
data set is deleted. 

User Response : If the error 
occurred on SYSIN or 
SYS 1 .SYS JOBQE, the user must wait 
until direct access space becomes 
available before submitting irore 
input. If the overload condition 
persists, he may request that more 
space be allocated to the 
resource. When core is not 
available for SYSOUT buffers, and 
the overload condition persists, 
the program should be rewritten so 
that the BLKSIZE of the SYSOUT 
data set is smaller. 
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| IHK162I SYSIN LIMIT EXCEEDED jobname 

Explanation ; The job (jobname) 
requires a SYSIN data set which 
exceeds the limit allowed by the 
procedure referenced at central 
startup. 

System Action : The job is 
refused, and a message is sent to 
the central operator. 

User Response ; The user may 
divide the SYSIN data for the job 
into smaller units, or he may 
request that a procedure allowing 
larger SYSIN data sets be used at 
the central system. 



| IHK163I 



DISK ERROR 

BRDCST DIRECTORY 

BRDCST MSG 

DELAYED MSG DIRECTORY 

DELAYED MSG 

JED [jobname] 

Q MGR RJE ABORTED 

Q MGR (jobname) 
\ (volume serial jobname ddname), 

Explanation ; An uncorrectable 
input/output failure has occurred 
while the program was attempting 
to write to or read from disk. 
One of the above messages to the 
central operator (and the user) 
indicates where the error 
occurred. 

(1) , (2) An error occurred while 

writing to or reading from 
the BRDCST directory or 
data set. 



System Action ; No further 
broadcast processing is done on 
the command (BRDCSTR or RJSTART) 
which triggered the error. Other 
processing continues normally. 



User Response ; Broadcast messages 
should not be requested until the 
central operator corrects the 
error . 

(3) , (4) An error occurred while 

writing to or reading from 
the delayed message 
directory or data set. 



System Action : No further delayed 
message processing is done on the 
command (MSGR or RJSTART) which 
triggered the error. Other 
processing continues normally. 



User Response : MSGR to another 
work station should not be used. 
Delayed messages should not be 
requested. The central operator 
should reinitialize the tables and 
inform the work stations when the 
error is corrected. 

(5) An error occurred while 

writing to or reading from the 
JED table on disk. The job 
(jobname) is lost in the event 
of a read error (when jobname 
appears in the message, a read 
error is indicated) . Write 
errors are indicated by no 
jobname. Discontinued output 
may be lost in case of a write 
error. 



System Action : On a read error 
the job is lost. On a write 
error, recovery is attempted. The 
central operator is informed if 
recovery attempts are not 
successful. If the write error 
occurs during discontinue mode, 
the system generates a dummy 
RJEND. At the next RJSTART the 
work station receives the disk 
error message. The last part of 
the discontinued output is lost. 



User Response : It is possible to 
receive the output from the lost 
job. (It cannot be deleted until 
after RJE closedown) . To avoid 
this, jobs should not be submitted 
with the same jobname until after 
the next RJE startup. 

(6) The OS queue manager has 

encountered a permanent I/O 
error in assigning. 



System Action : 
User Response : 



RJE is aborted. 
None. 



(7) The OS queue manager has 

encountered a permanent I/O 
error on SYS1.SYSJ0BQE. 

System Action : One or more of the 
following may occur: 

(a) An EOT is sent to the 
terminal 

(b) Job specified in jobname 
is cancelled 

(c) Fastable entry is deleted 

(d) Reader ready queue entry 
is deleted 
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(e) User is logged off 

(f) Disk error message is sent 
to the central CPU. 
Processing continues. 



(8) A disk error occurred while 
writing SYS IN data or reading 
SYSOUT data. 



User Response ; Resubmit the job 
if a jobname is specified. A 
LOGON may be issued at this time. 
A LOGON command may be necessary 
before resubmitting the job 
because the current user was 
logged off by the system. 

Note ; Since the user cannot tell 
when he has been logged off, it is 
suggested that a LOGON should be 
submitted prior to resubmitting 
the job. 



System Action ; If the error 
occurred on SYS IN data, an EOT is 
sent to the terminal. If the 
error occurred on SYSOUT data, r no 
further output from the data set 
is transmitted. The central 
operator is informed, and 
processing continues on the 
remainder of the job. 



User Response ; Resubmit the job 
to obtain the missing data set. 



HO 



CENTRAL COMMANDS 



The central operator communicates with 
the RJE system by means of central RJE com- 
mands. These commands provide the addi- 
tional capabilities needed by the central 
operator to control and maintain the RJE 
application, and to communicate with RJE 
users and work stations. If the RJE task 
is not active when the commands are issued, 
the commands are not accepted. The re- 
strictions imposed on format and placement 
of central commands are identical to those 
for JCL command statements. The central 
commands are introduced from the printer- 
keyboard or the system input device. When 
entered from the system input device, the 
commands contain the JCL identifier (//) in 
the first two positions of the command 
statement . 



FUNCTIONS OF CENTRAL COMMANDS 

The commands available to the central 
RJE operator provide a number of 
capabilities. 

1 . Commands used to control the RJE 
application: 

START 
STOP 

2. Commands used to maintain the RJE 
application: 

USERID 
CENOUT 
SHOW 

3. Commands used to communicate in the 
RJE system: 

MSG 
BRDCST 

Note : An RJE command statement cannot be 
continued. It must be coded on one card or 
card image. 

START — BEGIN RJE SYSTEM PROCESS 

The START command is used to start 
operation of RJE at the central 
installation. 



r t ■ 1 

| Operation | Operand | 

h + 4 

| J fFORM^ | 

| START j procname, , , < NFMT V | 

I j (NONE) j 
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procname 

specifies the name of the cataloged 
procedure for Remote Job Entry opera- 
tion. This procedure name must begin 
with characters RJE. 



FORM 



NFMT 



NONE 



RJE is to execute its Coldstart proce- 
dure. This form of the Start command 
must be coded if the OS System has 
been loaded with the following IPL 
option since RJE closed down. In the 
SET command, *F" was specified in the 
Q keyword subparameter list. 'F' 
indicates that the job-queue data set 
is to be formatted during the IPL. OS 
formatting of the job-queue data set 
deletes all jobs within the RJE Sys- 
tem. The FORM parameter removes all 
references to jobs in the RJE job 
table. If FORM is specified, all jobs 
within the RJE System are deleted 
regardless of OS startup. 



RJE is to execute its Warmstart proce- 
dure. This form is to be coded only 
if the OS System has been loaded since 
RJE closed down and the subparameter 

'F* of the keyword Q in the SET com- 
mand has not been specified. If the 
operator reloads the Operating System 
more than once since RJE closed down, 
and if, during any of the IPL proce- 
dures he specified 'F' in the SET com- 
mand, then FORM, not NFMT, must be 
coded on the START statement for RJE. 
If the operator loads specifying Q= ( 

[unitname] [,F] ) in the SET command, 
the RJE job table will retain its 
references to the jobs deleted by 
reformatting the job-queue data set. 
These references can be removed only 
by specifying FORM. 

Note : If the operator has not loaded 
OS since RJE closed down and NFMT is 
specified, no job output existing 
prior to closedown can be retrieved 
during this execution of RJE. To 
recover the output from the previous 
execution the operator must reload the 
Operating System (do not specify 'F' 
in the SET command) and start RJE spe- 
cifying NFMT. 



The Operating System has not been 
loaded since RJE closed down. This 
form of the START command can only be 
used under these conditions. 
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Note : If NONE is specified on the 
START statement and the operator had 
loaded OS since RJE closedown, all 
jobs within the RJE System are 
deleted. In addition, if the operator 
specified "F* in the SET command dur- 
ing the IPL, the RJE job table will 
retain its references to the deleted 
jobs. These references can be freed 
only by stopping RJE and reloading the 
Operating System and specifying FORM 
in the START command. 



userid 

specifies the userid which is to be 
added or removed from the user direc- 
tory. If this userid is already in 
the user directory, RJE rejects the 
command and informs the operator. 



key 



specifies the protection key assigned 
to the userid designated in the user 
parameter. This key need not be 
unique, i.e., the same key may be 
assigned to several user ids. 



ADD 



STOP — STOP RJE SYSTEM PROCESS 

The STOP command is used to stop opera- 
tion of RJE at the central installation. 



h 
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STOP 
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| procname 
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procname 

specifies the name of the cataloged 
procedure for Remote Job Entry opera- 
tions. This procedure name is the 
same as that specified in the START 
command. 



indicates that the userid and key are 
to be added to the user directory., 



DELETE 

specifies that the userid and key are 
-t to be deleted from the user directory, 

I 
H Note : If the addition of a userid and key 



is desired and no space is available in the 
user directory, the RJE program must be 
reassembled to increase the size of the 
user directory. 



CENOUT — GIVE RJE OUTPUT TO LOCAL OUTPUT 
WRITERS 



USERID — MODIFY THE RJE USER DIRECTORY 

The USERID command allows the central 
operator to modify and maintain the RJE 
user directory. The USERID command pro- 
vides the following capabilities: 

1 . A userid-key pair can be added to the 
user directory. 

2. A userid-key pair can be removed from 
the user directory. 

These facilities are provided dynamical- 
ly and do not require a reassembly of the 
RJE program. Each userid in the directory 
must be unique. If the central operator 
submits a command to add a userid that is 
currently contained in the user directory, 
RJE rejects the command and returns a mes- 
sage indicating that the userid is already 
contained in the directory. When a userid 
is removed from the directory, all jobs 
currently in the system associated with 
that userid are also removed. 



r t 
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| USERID j userid, key. 
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DELETE 
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The CENOUT command is used to remove job 
output in the RJE SYSOUT class and to pro- 
cess it with the central installation out- 
put writers. This command allows an opera- 
tor to retrieve output of completed, 
remotely submitted jobs which cannot be 
transmitted or have not been requested by 
an RJE user. The RJE system places the 
output data sets and system messages in the 
originally specified SYSOUT class. The 
disposition of the output is the same as 
that of any other data for that same SYSOUT 
class at the central installation. 

r t t 

| Operation | Operand | 
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| CENOUT |J=jobname j 
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J=jobname 

specifies the name of the job whose 
output is to be handled by the central 
installation output writers. If the 
requested job output is not complete 
or the job is not in the RJE system, 
the command is rejected and an indica- 
tion is returned to the operator. 

Note : The CENOUT command does not remain 
in the system. Only output of completed 
jobs is placed in the originally specified 
SYSOUT classes. Jobs which are completed 
after the command has been processed remain 
in the RJE SYSOUT class. 
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SHOW — DISPLAY RJE INFORMATION 



Values coded in the operand are: 



The SHOW command is used to request a 
printer-keyboard display of desired RJE 
information. The RJE information which may 
be displayed with this command is: 



1 . A list of jobs currently in the RJE 
system, indicating the status of each 
of these jobs. 

2. A list of work stations constituting 
the RJE system, indicating the state 
of each of them. 

3. A list of valid userids and their 
assigned keys, indicating whether or 
not the user is currently logged on. 

4. A list of all deferred RJE output with 
an indication of the time each has 
remained in the system. This indica- 
tion is a count of central RJE close- 
downs since the output was created. 

An option is provided to list only the 
deferred output for a particular user. 

5. A copy of the broadcast messages cur- 
rently available in the system. 

6. A list of all the messages that are 
waiting for a work station startup. 
This list indicates the work station 
for which each message is pending. An 
option is provided to list only those 
messages waiting for a particular work 
station startup. 

7. A list of the current values of all 
line error accumulators associated 
with all lines supported by RJE. 
These error accumulators contain data 
check, intervention required, and non- 
text time-out counts, and the number 
of transmissions for the line since 
the last RJE central startup. An 
option is provided to list only the 
error accumulators for a particular 
line. 



The information desired is specified 
with a coded value in the SHOW command 
operand. Only one parameter may be speci- 
fied for the operand of each command. If 
more than one type of available RJE infor- 
mation is wanted, it must be requested with 
multiple SHOW commands. 



JOBS 



r t 
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SHOW 



JOBS 
TERMS 
USERS 
DEFER 

DEFER, user id 
BRDCST 
MSGS 

MSGS , termid 
LERB 

LERB , linename 
S, 



requests a list at the central instal- 
lation, of RJE jobs and their status. 
The status returned indicates only 
whether the job is complete. 



TERMS 



requests a list of the work stations 
constituting the RJE system and the 
state of each work station. The dis- 
play also indicates whether the work 
station is currently attached to the 
system. 



USERS 



results in a display of a list of all 
valid userids and their associated 
keys, with an indication of whether or 
not each user is currently logged on. 



DEFER 



requests a list of all jobs which have 
deferred job output waiting in the RJE 
SYSOUT class, with an indication, for 
each job, of the time the output has 
remained in the system. The indica- 
tion returned is the number of central 
closedowns occurring since the output 
was created. 



DEFER, user id 

requests a list of all jobs associated 
with the specified users which have 
deferred output waiting in the RJE 
SYSOUT class, with an indication of 
the time each output has remained in 
the system. This time is indicated by 
the number of central closedowns 
occurring since the output was 
created. 

BRDCST 

requests a copy of the current broad- 
cast messages. 

MSGS 

requests a copy of all RJE messages 
which are waiting for work station 
startup. The work station to which 
each message is directed is indicated 
in the list. 

MSGS, termid 

requests a copy of RJE messages wait- 
ing for the specified work station. 
If the termid specified does not 
correspond to a work station in the 
system, the command is rejected. 



LERB 



requests a list of the current values 
of all line error accumulators for all 
the communication lines being used for 
RJE. The list indicates for each line 
the three error-counter values (data 
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check, nontext time-out, and interven- 
tion required) , and the transmission- 
counter value. These values are cumu- 
lative since the last RJE central 
startup. They are reset to zero at 
central startup. 

LERB, linename 

requests the error and transmission 
counts for a particular line. The 
linename is the name which was speci- 
fied for the line when the central RJE 
program was assembled. The central 
operator receives a message containing 
the three error- counter values and the 
transmission-counter value for the 
line designated. 



MSG 



COMMUNICATE WITH RJE USERS 



The MSG command is used to send messages 
to the users and work stations constituting 
the RJE system. The central operator may 
selectively route a message to: 

1. A specific user currently logged on 

2. A specific work station 

3. A specific user or, if the user is not 
logged on, a specific work station 

4. All work stations logically attached 
to the RJE system. 

In addition, the MSG command allows 
removal from the system of those messages 
which are waiting for work station startup. 
This option is normally used when communi- 
cation between the central installation and 
a work station is not possible due to some 
failure, or when the data set where these 
pending messages are kept becomes full. 
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I | D=termid | 
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U=userid 

specifies that the message is to be 
sent to the user identified by the 
coded userid. The message is sent to 
the user if he is logged on. If the 
user is not logged on and the T key- 
word is omitted, the message is not 
sent. A response indicating this con- 
dition is returned to the operator. 
If both the T and U keyword parameters 
are specified and the user is not 
logged on, the message is sent to the 
work station or is held until work 
station startup. 



T=termid 

specifies that the message is to be 
sent to the work station identified by 
the coded termid. If the work station 
is inactive the message waits until an 
RJSTART command is submitted. 

M='text' 

specifies the text of the message to 
be sent. The message text must be 
framed with apostrophes and may 
include as many as 40 printable char- 
acters and blanks. Any apostrophes 
included as part of the text must be 
paired, and each pair counts as one 
text character. If the operator omits 
the U and T keyword parameters, th e 
message is sent to all work stations 
logically attached to the RJE system . 
Work stations in the inactive state 
when the command is issued do not 
receive the message. 

Note : The message text must be entered in 
upper case. 

D=termid 

deletes the pending messages for the 
work station identified by the coded 
termid. A copy of these messages can 
be obtained with a SHOW MSGS, termid 
command before entering the MSG D= = 
termid command. The message is for- 
matted for the work stations as 
follows: 

RJE MSG [userid] FR*C* text 

userid - If the U option is used 

BRDCST — MAINTAIN THE RJE BROADCAST 
MESSAGES 

The BRDCST command is used to maintain 
the broadcast messages. These messages are 
kept in a data set (on a direct access 
device) with provisions for up to 100 
broadcast messages. Each broadcast message 
in the data set is numbered to correspond 
with a numbered slot. These slots are num- 
bered from to 99 and are either active 
(containing a message) or inactive (con- 
taining no message) . The BRDCST command 
allows the central operator to: 

1 . Insert a new message 

2. Add a new message 

3. Change an existing message 

4. Remove an existing message 

5. Collect active messages into the low- 
est numbered slots available 

6. Clear the data set of all existing 
messages. 
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nn, 'text* 
text' 
BRDCST j^nn 

i DELETE 
Ann, 'text' 
.PACK 
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nn, 'text' 

specifies the 'text* to be placed into 
the slot number nn of the data set. 
The slot is set to active regardless 
of the original status of the speci- 
fied slot. 



1 text • 

specifies that text is to be placed 
into the lowest numbered inactive 
slot. If no slots are inactive, the 
command is refused. 



nn 

specifies that the text contents of 
slot number nn be deleted. This is 
done by merely setting that slot to 
inactive . 

DELETE 

requests the deletion of all texts for 
the BRDCST data set. 



Ann , ' text ' 

specifies the insertion of the TEXT 
into slot number nn. The text is 
inserted in slot nn if the slot is 
inactive. If the slot is active, the 
text is inserted in slot nn after 
sequentially moving the texts of that 
slot and of all consecutive active 
slots into a higher-numbered inactive 
slot. This preserves the contents and 
sequential order of all original 
texts. If there is no higher inactive 
slot to receive the pushed up texts, 
this command is rejected. If the com- 
mand is rejected, the parameter PACK 
may be used to compress the data set 
and allow insertion of the message. 



PACK 



specifies the collection of all active 
slots at the 00 end of the directory 
and of all inactive slots at the 99 
end. This function may be used to 
recover from the insert command (see 
previous paragraph) being refused due 
to a lack of a higher inactive slot. 
The contents and sequential order of 
all active slots are preserved. 



Note : A copy of the broadcast message data 
set (active messages) may be obtained by 
the central operator with the SHOW BRDCST 
command. 

Note ; The message text must be entered in 
upper case. 
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MESSAGE RESPONSES TO THE CENTRAL OPERATOR 



IEE301I jjj JOB CANCELLED 

Explanation : The job named jjj 
was cancelled either by a CANCEL 
command submitted by the operator 
or by RJE. 

System Action : All references to 
the job are deleted from the 
system. 

Operator Response : None. 

(NO CORE | 
IEE305I ] (blanks) J COMMAND INVALID 
(CSCB USE' 

Explanation : NO CORE indicates 
that core was not available to 
process the central command. 

If blanks appear, the operand of 
the central command was too long, 
or a framing quote was not found 
within 62 bytes. 

CSCB USE indicates that another 
central command was being 
processed in the system when a 
second was submitted. 



System Action : 
rejected. 



The command is 



Operator Response : When NO CORE 
or CSCB USE is printed, resubmit 
the command at a later time. If 
blanks appear, correct the command 
and resubmit it. 



IEE32 6I RJE NOT SUPPORTED 



Explanation : RJE was not in the 
system or had not yet completed 
initialization when an RJE central 
command was submitted. 



System Action : 
rejected. 



The command is 



Operator Response : Resubmit the 
command after RJE is started and 
has completed initialization. 



IHK001I USER LOGGED ON userid key 

Explanation : A display of 
assigned userid-key pairs has been 
requested. The userid-key pair 
displayed is assigned to an RJE 
user who is currently logged on. 



System Action : Reporting 
continues until all assigned 
userid-key pairs are displayed. 

Operator Response : None. 



IHK002I USER LOGGED OFF userid key 

Explanation : A display of 
assigned userid-key pairs has been 
requested. The userid-key pair 
displayed is assigned to an RJE 
user who is currently logged off. 

System Action : Reporting 
continues until all assigned 
userid-key pairs are displayed. 

Operator Response : None. 



IHK004I NO JOB (S) IN SYSTEM [ jobname] 

Explanation : A display of 
remotely submitted jobs resident 
in the central system has been 
requested. No remotely submitted 
jobs are in the central system or 
a CENOUT command for job (jobname; 
was issued and was not found in 
the system. 

System Action : None. 

Operator Response : None. 



IHK005I JOB (S) NOT COMPLETE jobname userid 

Explanation : A display of 
remotely submitted jobs resident 
in the central system has been 
requested. The job (jobname) 
submitted by the user (userid) is 
not complete, or a CENOUT command 
for a job (jobname) was issued and 
the job was not complete. 

System Action : Reporting 
continues until all remotely 
submitted jobs are displayed. 

Operator Response : None. 



IHK007I JOB DELETED jobname 

Explanation : The job (jobname) 
submitted at the central system 
has placed output in the RJE 
SYSOUT class. 
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System Action : The job and its 
output are deleted. 

Operator Response : The operator 
should tell the programmer who 
submitted the job not to use the 
RJE SYSOUT class. 



IHK011I MSG PENDING STARTUP (NONE 

jtermid 
(termid NONE 



Explanation : The operator has 
requested either a display of 
messages waiting for a work 
station startup or a transmission 
of a message to an inactive work 
station. If a display was 
requested, the requested messages 
are displayed. NONE indicates 
that no messages are pending. 

Termid NONE 

indicates there are no 
messages waiting for a 
specified terminal. 

System Action : If a display has 
been requested, reporting 
continues until all the pending 
messages requested are displayed. 
If message transmission has been 
requested, the message is held 
until the work station initiates 
startup procedures, unless the 
central operator deletes the 
message. 

Operator Response : None. 



IHK012I MSG QUEUED FOR DELIVERY <userid 

] termid 
f TERMINALS 

Explanation : The message 
specified in the MSG command is 
awaiting delivery either to the 
specified user (userid) , to a 
specified work station (termid) , 
or to all active work stations 
(TERMINALS) . 

System Action : The message is 
transmitted as soon as the work 
station will accept it- 
Operator Response: None. 



Explanation : The request for 
message transmission cannot be 
serviced because: 

userid - The message is directed 
to a user who is not 
logged on 

termid - The central system has no 
space to keep a pending 
message 

TERMINALS - No work stations are 
active 

DISK ERROR - The message could not 
be held on the message 
pending data set for the 
terminal . 



System Action : 
ignored. 



The request ii 



IHK013I MSG IGNORED 



userid 
termid 
TERMINALS 
DISK ERROR 



Operator Response : If immediate 
action is required, the operator 
may use the telephone. Pending 
messages for inactive work 
stations can be displayed and, if 
necessary, deleted to make room. 

IHK014I MAX JOBS EXCEEDED jobname 

Explanation : The number of job 
entries currently maintained by 
the central system is the maximum 
specified by the installation. 
The job entry (jobname) cannot be 
accepted. 

System Action : The job is refused 
and a message is returned to the 
remote user submitting it. 

Operator Response : If the 
condition persists, the central 
system must be reassembled to 
support more remote jobs. The 
operator may alleviate the 
condition by submitting the CENOUT 
command. This command causes 
remotely submitted job output to 
be written at the central 
installation. If this is done, 
the user who submitted the job 
should be notified. 

IHK016I RJE CLOSED DOWN 

Explanation : The central RJE 
system has completed closedown 
procedures. 

System Action : RJE operation is 
terminated until the next startup. 
All active work stations are 
notified of the central closedown 
and are logically detached from 
the system. 
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Operator Response : None. 



IHK019I JOB WAITING DELIVERY jobname 

Explanation : A CENOUT command was 
issued for a job (jobname) which 
has immediate output or has 
already been queued for delivery 
to the terminal. 



System Action : 
ignored. 



The command is 



Operator Response : None. 



IHK02UI WARMSTART NOT EXECUTED 

Explanation : The last closedown 
of RJE was abnormal. RJE was 
started with START procname , , , NONE 
which indicated that no IPL was 
performed. 

System Action : RJE warmstart was 
not executed. Processing 
continues . 

Operator Response : If there was 
no IPL, no action is required. If 
an IPL was performed, press system 
reset key, reload OS, do not 
reformat the queues, and enter 
S TART procname , , , NFMT . 



IHK02 5I START RJE REJECTED 

Explanation : A START RJE is 
invalid at this time. No STOP RJE 
has been processed since the last 

START RJE. 



S ystem Action : 
not processed. 



The START RJE is 



Operator Response : If another 
version of RJE is desired, the old 
version must be stopped; then the 
START RJE may be submitted and 
processed. 



IHK026I CENOUT jobname (class, .. .class) 

Explanation : A request to have 
the output of the remotely 
submitted job (jobname) written at 
the central installation has been 
accepted. The job output is 
placed in the listed SYSOUT 
classes. 

S ystem Action : The job output is 
removed from the RJE SYSOUT class 
and placed in the indicated SYSOUT 
classes. 



Operator Response : The operator 
starts output writers for these 
classes when the output is 
desired. 



IHK027I WORK STATION termid /ACTIVE \ 

(.INACTIVE) 



Explanation : A display of RJE 
work stations has been requested. 
The message indicates the name of 
the work station (termid) and 
whether or not the work station is 
logically attached to the central 
system. 

System Action : Reporting 
continues until all work stations 
are displayed. 

Operator Response : None. 



IHK028I DEFERRED OUTPUT (NONE 



(NONE ) 

} jobname userid n[ 
(userid none J 



Explanation : A display of jobs 
having deferred output has been 
requested. The request addresses 
either all deferred output in the 
central system, or that for a 
specific RJE user. The jobname, 
the user who submitted the job, 
and the number of central 
closedowns (n) since job 
completion are displayed for each 
job addressed. NONE indicates 
that none of the deferred output 
requested is in the central 
system. 

Userid NONE 

indicates that no deferred 
output for the specified user 
(userid) is in the central 
system. 

System Action : Reporting 
continues until all of the 
deferred job output addressed by 
the request is displayed. 

Operator Response : None. 

IHK029I JOB COMPLETE jobname userid 

Explanation : A display of 
remotely submitted jobs in the 
central system has been requested. 
The job (jobname) submitted by 
user (userid) is complete. 

System Action : Reporting 
continues until all remotely 
submitted jobs are displayed. 
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Operator Response : None. 



Opera-tor Response : None , 



IHK030I DELETED FROM USER DIRECTORY user id 
key 



Explanation : The request to 
delete the indicated userid-key 
pair from the user directory has 
been serviced. Deletion of this 
pair leaves space for another 
userid-key assignment. 

System Action : All jobs submitted 
by this user are deleted. 

Operator Response : None. 



IHK031I ADDED TO USER DIRECTORY userid key 

Explanation : A request to add the 
userid-key pair to the user 
directory has been serviced. The 
user assigned this userid-key can 
now gain access to the system. 

System Action : The userid-key is 
placed in the user directory. 

Operator Response : None. 



IHK032I USER DIRECTORY FULL userid key 

Explanation : A request to add Lhe 
userid-key pair to the user 
directory cannot be serviced. The 
user directory already contains 
the maximum number of RJE users. 



Ibrdcst 



System Action : 
ignored. 



The request is 



Operator Response : The operator 
might make space available by 
deleting a userid-key pair no 
longer being used. If this is not 
feasible, he may have the central 
RJE system reassembled to support 
more users. 



IHK034I MSG CANNOT BE ADDED j DELAYED) termid 



Explanation : (BRDCST) A request 
to add or insert a message into 
the broadcast message data set 
could not be serviced. Either the 
data set was full or, if the 
message was to be inserted, there 
were no higher numbered inactive 
slots available. 

(DELAYED) The messages which 
follow this header could not be 
added to the delayed message data 
set when an RJEND statement was 
processed for the work station 

(termid) because the data set was 
full, or because a disk error was 
detected. This occurs when the 
RJEND is submitted from the work 
station or simulated because of an 
error condition. 



System Action : (BRDCST) The 
request is ignored. 

(DELAYED) All messages which could 
not be added to the data set are 
printed on the central 
printer-keyboard. 



Operator Response : (BRDCST) If 
the message was to be inserted, 
there may be inactive slots above 
the slot specified. If there are 
no inactive slots, no message can 
be added until one slot is made 
inactive. 

(DELAYED) Inform the work station 
after its next RJSTART or 
telephone the work station 

(termid) to give its operator this 
information. 



IHK033I MSGS DELETED FOR WORK STATION 
termid 

Explanation : A request to delete 
the messages waiting for work 
station (termid) startup has been 
serviced. 

System Action : The pending 
messages are deleted from the 
central system. 



IHK035I INVALID SLOT NUMBER BRDCST 

Explanation : A slot number not 
within the range of 0-99 was 
specified on the BRDCST command. 



System Action : 
ignored. 



The command is 



Operator Response : The operator 
corrects the slot number and 
resubmits the command. 
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IHK036I BRDCStJnONE 

inn message 



Explanation : A display of the 
current broadcast messages has 
been requested. The slot number 
(nn) is followed by the message 
text contained in the slot. Only 
active slots are displayed. NONE 
indicates that the data set is 
empty . 

System Action : Reporting 
continues until the contents of 
all active slots are displayed. 

Operator Response : None. 



IHK037I INFORM INACTIVE WORK STATION 
jobname userid termid J N 

1° 

Explanation : The job (jobname) 
submitted by the user (userid) at 
the work station (termid) has 
completed. Either a notify 
message (N) or immediate job 
output (0) is directed to this 
inactive work station connected 
via a switched line to the central 
system. 

System Action : The message or 
output is held at the central 
system until the work station 
(termid) submits an RJSTART 
command or the user (userid) logs 
on at another work station. 

Operator Response : The operator 
may telephone the work station 
(termid) and give its operator 
this information. 



IHK03 8I INVALID LINENAME SHOW 

Explanation : A request to display 
error information for a particular 
line or line group specifies an 
invalid linename. 



System Action : 
ignored. 



The request is 



Operator Response : The operator 
supplies the correct linename and 
iresubmits. 



the user directory, the userid is 
already in the directory. 



System Action : The command is 
ignored. 



Operator Response : The operator 
corrects the userid and resubmits 
the command. 



IHK041I INVALID PROTECTION KEY userid 

Explanation : A request to delete 
a userid-key pair in the user 
directory cannot be serviced. The 
key specified in the command does 
not agree with the key contained 
in the user directory. 



System Action : 
ignored. 



The command is 



Operator Response : The operator 
supplies the correct key and 
resubmits the command. 



IHK042I INVALID TERMID operation 

Explanation : The command 
(operation) specifies a termid not 
assigned to a work station in the 
RJE system. 



System Action : 
rejected. 



The command is 



Operator Response : The operator 
corrects the termid and resubmits 
the command. 



IHK047I REQD PARAMETER MISSING operation 

Explanation : A required parameter 
in the operand field is missing or 
invalid in the statement 
(operation) . 



System Action : 
rejected. 



The command is 



Operator Response : The operator 
examines the statement in error, 
corrects the parameter, and 
resubmits command. 



IHK04 0I INVALID USERID operation 

Explanation : The command 
(operation) specifies a userid 
which is not contained in the user 
directory, or, if the command 
requests addition of a userid to 



IHK048I ILLEGAL DELIMITER operation 

Explanation : A parameter in the 
operand field of the command 
(operation) is not delimited by a 
comma, or, if it is the last 
parameter, a blank. 
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System Action : 
rejected. 



The command is 



Operator Response : The operator 
corrects the command and resubmits 
it. 



IHK04 9I ILLEGAL CONTINUATION operation 

Explanation : The command 
(operation) has continuation 
indicated with a non-blank 
character in column 71. Commands 
may not be continued. 



System Action : 
rejected. 



The command is 



Operator Response : The operator 
corrects the command and resubmits 
it. 



IHK050I UNDEFINED KEYWORD operation 

Explanation : An undefined keyword 
is included in the command 
(operation) . 

System Action : The command is 
ignored. 

Operator Response : The operator 
corrects the error and resubmits 
the command. 



IHK061I OUT OF SPACE (SYSIN jobname ]| 

{SYSl.SYSJOBQE 

I EMITTER WORKAREA j 



Explanation : An out of space 
(overload) condition exists at the 
central station system. Either 
all direct access storage space 
that is allocated for the resource 
SYSIN or SYS 1 . SYSJOBQE is in use. 
If EMITTER WORKAREA is specified, 
the emitter could not get the 
output work area required because 
core was not available when 
requested. 



System Action : The user 
submitting the input is informed 
of the condition. Until space 
becomes available, all input 
requiring the depleted resource is 
rejected. When EMITTER WORKAREA 
is specified, no output to the 
terminal can occur until the core 
is available. An EOT is sent,. 
The central system waits for more 
input from the remote work 
stations. When the EOT is 
received following the input, the 
emitter again tries to obtain core 
for its work area. No jobs are 
lost, but they are delayed in 
being returned to the remote work 
station until sufficient core is 
available. 



IHK051I MULTIPLE USE OF KEYWORD operation 

Explanation : A keyword is 
repeated in the command 
(operation) . 

System Action : The command is 
ignored. 

Operator Response : The operator 
corrects the error and resubmits 
the command. 



IHK055I INCORRECT TEXT LENGTH operation 

Explanation : The text specified 
in the command (operation) either 
exceeds the allowable length or 
has a length of zero. Message 
text must be from 1 to 40 
characters. 



System Action : 
ignored. 



The command is 



Operator Response : The operator 
corrects the error and resubmits 
the command. 



Operator Response : If the 
overload condition persists, the 
operator may request that more 
space be allocated to the 
resource. 



IHK062I SYSIN LIMIT EXCEEDED jobname 



Explanation : The job (jobname) 
demands a SYSIN data set exceeding 
that specified in the procedure 
referenced when the central system 
was started. 



System Action : The job is 
rejected, and a message is 
returned to the user submitting 
the job. 



Operator Response : If the job 
must be processed, the operator, 
when the central system is 
restarted, should reference a 
procedure allowing larger SYSIN 
data sets. 
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IHK063I DISK ERROR 

/WRITING TABLE ENTRY \ (1) 

ROLLIN TABLES RJE ABORTED (2) 

BRDCST DIRECTORY (3) 

BRDCST MSG (4) 

DELAYED MSG DIRECTORY (5) 

DELAYED MSG I (6) 

JED [ jobname/PURGE SYSTEM] | (7) 

Q MGR RJE ABORTED (8) 

Q MGR (jobname) (9) 
(volume serial jobname ddname) (10) 

[IN CLOSEDOWN /(1 1) 



Operator Response : The central 
operator should enter SHOW MSGS, 
then STOP RJE. Before the next 
START RJE r the broadcast-message 
data sets should be reinitialized 
(IHKCDBMI) . All old messages are 
lost. 

(5) , (6) An error occurred while 

writing to or reading from 
the delayed message 
directory or data set. 



Explanation : An uncorrectable 
input/output failure has occurred 
while the program was attempting 
to write to or read from disk. 
One of the messages above 
indicates to the central operator 
(and the user) where the error 
occurred. 

(1) An entry in the core copy of 
an RJE control table could not 
be written to disk. 



System Action : No further 
processing is done on the command 
(SHOW MSGS, MSG, MSGR) that 
triggered the error. If the error 
was incurred while processing 
RJSTART, all processing continues 
except the reading of delayed 
messages. If the error occurred 
during of processing of RJEND, the 
messages are written to the 
central console, and processing 
continues . 



System Action : Processing 
continues using the version of the 
tables in core. No subsequent 
messages are sent. 

Operator Response : The operator 
should inform the users of the 
problem. It is recommended that 
the work stations not submit any 
more jobs and retrieve all delayed 
jobs. The operator should STOP 
RJE and reinitialize the tables 
before the START RJE. Any jobs 
remaining in the system after the 
STOP RJE are lost. 

(2) The disk copy of the control 
tables could not be brought 
into core. 

System Action : RJE is aborted. 

Operator Response : (a) Move the 
disk containing the RJE table to 
another drive. Attempt to START 
RJE again. (b) If the error 
persists, run IHKINTAB. The 
status information in the tables 
will be lost. START RJE again. 

(3) , (4) An error occurred while 

writing to or reading from 
the BRDCST directory or 
data set. 

System Action : No further 
broadcast processing is done on 
the command (BRDCST, BRDCSTR, 
RJSTART, SHOW) that detected the 
error. Other processing continues 
normally. 



Operator Response : The central 
operator should SHOW BRDCST, then 
STOP RJE. Before the next START 
RJE, the broadcast-message data 
sets should be reinitialized 
(IHKCDBMI) . All old messages are 
lost. 

(7) An error occurred while 

writing to or reading from the 
JED table on disk. The job 
(jobname) is lost in the event 
of a read error. Write errors 
are indicated by no jobname. 
PURGE SYSTEM indicates no 
recovery could be made from a 
write error. 

System Action : On a read error, 
the job is lost and the submitter 
is notified. On a write error, 
recovery is attempted; the 
submitter is notified only if no 
recovery could be made. PURGE 
SYSTEM indicates no recovery could 
be made. 

Operator Response : In the event 
of a read error, the operator may 
scratch these data sets associated 
with the jobname indicated in the 
message after RJE has closed down. 
Otherwise, they will be deleted at 
the next OS warmstart. If the 
system could not recover from a 
write error, the operator should 
inform the work stations that all 
output should be requested. He 
should STOP RJE and reinitialize 
the RJE control tables before 
START RJE. 
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(8) The OS queue manager routine 
has encountered a permanent 
I/O error. 

System Action ; RJE is aborted. 

Operator Response ; To attempt 
recovery without losing jobs in 
the system, reload OS without 
reformatting the queues. If this 
is unsuccessful, reload OS and 
reformat queues. If the disk 
error persists call a customer 
engineer. 

(9) The OS queue manager has 
encountered a permanent I/O 
error on SYS1 .SYSJOBQE. 

System Action ; One or more of the 
following may occur; 

(a) An EOT is sent to the 
terminal 

(b) Job specified in jobname 
is cancelled 

(c) Fasttable entry is deleted 

(d) Reader ready queue entry 
is deleted 

(e) User is logged off 

(f) Disk error message is sent 
to user. Processing 
continues. 

Operator Response ; Continue 
operation unless the disk error 
persists. Reformat queues at next 
IPL. If the error persists after 
reloading, call a customer 
engineer. 

(10) A disk error occurred while 
writing SYSIN data or reading 
SYSOUT data. 

System Action ; If the error 
occurred on SYSIN data, an EOT is 
sent to the remote terminal, and 
an attempt is made to send the 
disk error message to the 
terminal. If the error occurred 
on SYSOUT data, no further output 
from the data set is transmitted, 
and the terminal receives this 
message. Processing continues 
with the remainder of the job. 

Operator Response ; If the error 
persists, STOP RJE. The error may 
be corrected by changing the disk 
pack or drive. 



(11) During RJE closedown 

procedures, an ECB is not 
removed from the OS queue 
manager. 



System Action ; The closedown 
procedure continues. 



Operator Response ; Before the 
next START RJE reload OS without 
reformatting the queues. 



IHK064I LINE XXX NOT OPERATIONAL 



Explanation ; The control unit for 
this line is nonoperational. 

System Action ; The line is placed 
in a wait state until an RJE 
closedown. 

Operator Response ; Notify 
customer engineering of problem. 



IHK065I UNABLE TO OPEN DDNAME=xxxxxxxx 

Explanation ; The DDNAME for the 
line specified in the DCB cannot 
be found in the RJE procedure,. 

System Action ; The request for 
use of this nonexistent line is 
placed in a wait state until an 
RJE closedown. 

Operator Response ; Notify system 
programmer of error. 

IHK066I termid NOW RESPONDING TO POLLING 

Explanation ; The terminal that 
was indicated as not responding to 
polling has now responded. 

System Action ; None. 

User Response ; None. 

IHK067I termid NOT RESPONDING TO POLLING 

Explanation ; The terminal 
indicated is not responding to 
polling. 

System Action ; None. 

User Response ; Check to see that 
power switch is on; if it is not 
on, turn it on. If the switch is 
on, notify customer engineer of 
problem. 
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COMPLETION CODES 



If RJE completes abnormally with any of 
the following codes, the Operating System 
must be reloaded before RJE can be 
restarted. In order to save information 
that has been enqueued, the system is 
loaded without formatting SYS 1 . SYS JOBQE and 
RJE is started with the START command in 
the following format: 

START procname , , , NFMT 



User Response ; Execute the job again. 
If the error persists, call a customer 
engineer. 



012 Explanation; An open of one of the 

data sets specified in the Remote Job 
Entry procedure has failed. The most 
probable causes are; 



010 Explanation: The error was detected 
during execution of a BDAM READ or 
WRITE macro instruction. 

An uncorrectable input/output error 
was detected in attempting one of the 
following: 

• To dequeue system output (SYSOUT) 
data from the Remote Job Entry 

(RJE) SYSOUT class 

• To dequeue input from the 
SYS 1. SYS JOBQE data set 

• To delete input from the 
SYS 1 .SYS JOBQE data set 

• To assign a queue entry to the 
SYS 1. SYS JOBQE data set 

User Response ; Execute the job again. 
If the error persists, call a customer 
engineer. 



• An omitted DD statement 

• A misspelled DD name in the 
procedure 

• Or the DD statement for system 
input (SYSIN) specifies device 
which is not a direct access 
device. 



User Response ; Inspect the Remote Job 
Entry procedure for misspelled or 
omitted DD statements, and update the 
RJE procedure as required. If the 
error persists and is not caused by an 
invalid procedure, call a customer 
engineer. 



013 Explanation; A read error occurred 
either during the initialization of 
the Remote Job Entry tables or during 
RJE startup. 



011 Explanation: The error was detected 
during an attempt to execute a 3TAM 
READ CONTINUE macro instruction. 



User Response : Execute the job again. 
If the error persists, call a customer 
engineer. 
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RJE GENERATION 



The generation of an RJE system for the 
central system consists of two steps: 

1 . Generation of the Operating System 
with the options required to make RJE 
available in the system 

2. An RJE assembly and link-edit step in 
which the specific RJE facilities 
desired are included in the system. 
Once the general RJE capabilities have 
been made available with one Operating 
System generation, any number of dif- 
ferent RJE systems can be built using 
the assembly and link- edit step. 

OPERATING SYSTEM GENERATION CONSIDERATIONS 

To incorporate an RJE capability into 
his Operating System, the user, when he 
generates his OS system, must include 
OPTIONS=RJE as a parameter in the SCHEDULR 
macro instruction, and ACSMETH=BTAM,BDAM in 
the DATAMGT macro instruction. When 
OPTIONS=RJE and ACSMETH=BTAM, BDAM are spe- 
cified, the necessary RJE and. BTAM modules 
are copied from the MODLIB onto the TELCM- 
LIB (nonresident RJE modules are copied to 
LINKLIB, with the exception of the module 
IHKCDINI which is copied on to the TELCMLIB 
to be link edited with the resident 
modules) . These modules are then available 
for later assembly and link editing of the 
central RJE system program. 

In addition, the following system 
generation, macros, and options are 
required for generation of a system sup- 
porting RJE. 



IOCONTRL. 



One macro is required to 



describe each telecommunications con- 
trol unit (2701 or 2703) . 

• IODEVICE . One macro is required for 
each communications line. 



Complete descriptions of these macros, 
their formats, and OS system generation 
procedures are found in the publication IBM 
System/360 Operating System: System 
Generation, Form C28-6554. 



SPECIFYING THE RJE SYSTEM 

The particular RJE system is specified 
by the user through four RJE assembly macro 
instructions : 

1 . RJETERM . One macro instruction is 
required for each supported work 
station . 

2. RJELINE . One macro instruction is 
required for each communication line 
supported. 

3. RJEUSER . One macro instruction is 
required to indicate the number of 
valid users of the RJE system and 
their identifications (userids) . 

1 • RJETABL . One macro instruction is 
required to specify general informa- 
tion such as desired user exits, 
device association for SYSOUT data, 
and maximum number of job entries that 
may reside in the central system at a 
given time. 

With these RJE macros, the user speci- 
fies an RJE system to meet his particular 
data processing requirements and defines 
the telecommunications network to be sup- 
ported. The RJE program for the central 
installation is produced by link editing of 
object modules, resulting from the assembly 
of these RJE macros, with preassembled 
modules on TELCMLIB, and with preassembled 
user routines. 



• TELCMLIB . This must be specified to 
include RJE modules and the telecom- 
munications subroutine library. 

• PROCLIB . This macro must be specified 
for inclusion of a procedure library. 

• ASSEMBLR . This must be specified so 
that the RJE macros can be assembled. 

• EDITOR . This must be specified so that 
the assembled RJE macros can be link 
edited. 

• MAC LIB . This must be specified to 
allow the assembler to expand the RJE 
macros . 



Figure 6 shows the flow of data through 
the RJE assembly and link-edit step. The 
OS/360 Assembler translates the RJE macros 
and creates the modules that tailor the 
system to the particular application. This 
step also produces linkages to the preas- 
sembled modules, common to all RJE systems, 
and to the desired user exits. 

The object modules produced by the 
Assembler are edited by the OS/360 Linkage 
Editor. This editing resolves the linkages 
created in the first step and produces the 
executable RJE program ready for use. The 
linkage editor output (the RJE load module) 
must be placed in the SYS 1. LINKLIB when the 
RJE generation process is complete. 
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Assembly of RJE Macro Instructions 




Figure 6. RJE Assembly and Link Edit 

Figure 6. RJE Assembly and Link-edit 
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J Operation j 
RJELINE 



name 



[name] 
[name] 



RJETERM 



RJEUSER 
RJETABL 



Operand 
DDLINE=ddname 
, DDS YS IN=ddname 



,RLN=1 



, RLN=mteger 

, LERB= 



] 



=[ integer , , integer 2 , integer 3 , integer* ] 
\L 255 JLk)JL 5 J L 5 ]/_ 



[,ID=({2780 or 1 130, chars, termid} , . . .) ] 

[,MODE= [IBC] |_rBj|_,Bj 

|TYPE=2780 



[ TYPE=2780 | 

[type=cpu J 

r,PUNCH=YES ] 
|_,PUNCH=NO J 



',PRTSZ=120 
r PRTSZ=132 
,PRTSZ=144 



[,ID=chars] 

integer [, [2780 or 1 130 r userid r key} , 

JOB=integer 
, SYSPRT=char 
, SYSPCH=char 
,SYSUSER=char 
, SYSRJE=char 

;,JOBCARD=routine name] 

r JOBACK=routine name] 

', COMMERR=routine name] 

,BUFNO=1 "I 



Figure 7 . 



■t BUFNO=integer J 

—J l 

Summary of RJE Macro Instructions 






RJE ASSEMBLY MACRO INSTRUCTIONS 

The contents of the RJE system to be 
generated are specified by the RJE macro 
instructions. The coding conventions and 
formats of the macros are the same as those 
for normal assembly macro instructions. 
Figure 7 provides a summary of RJE macro 
instructions . 



RJELINE - DESCRIPTION OF THE COMMUNICATIONS 
LINE 

The RJELINE macro instruction designates 
characteristics that are required by RJE to 
service the communications line and 
attached work stations. One macro is spec- 
ified for each line that RJE must support. 
The RJELINE macros must appear first in the 
macro deck. In addition, when line groups 
are used, they must be grouped by relative 
line numbers in ascending order. Line 



group denotes a logical grouping of com- 
munication lines. This grouping is done by 
concatenation of DD statements in the cata- 
loged procedure, or with the UNITNAME macro 
during system generation. If lines are to 
be grouped, two conditions must be met: 

1. All line connections must be the same, 
either switched or nonswitched. 

2. All work stations within the line 
group must be of the same type. 

Additional explanation of line groups is 
provided in the publication IBM System/360 
Operating System: Basic Telecommunications 
Access Method , Form C3 0-20 04. Information 
supplied by this macro provides: 

1 . Access to line information specified 
at system generation 

2. Identification of line groups, to 
avoid a need for additional control 
blocks 
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3. Threshold values for error counters 
which cause an error message to be 
displayed to the central operator when 
any of the values is reached 

4. The polling list for multidrop lines, 
giving the polling characters of the 
work stations 



| Name j Operation j Operand 



name 



RJELINE 



I DDLINE=ddname 
, DDSYSIN=ddname 

, RLN=1 

, RLN=integer 

, LERB=/ [integer i i , 
U 255 J 



— i 

I 

—I 



[integer J , 

L ™ J 

[integer 3 , 
5 J 

[integer^ \ 
5 \) 



[ r ID= (type, {2780 or 1130, 
chars,termid} ,...)] 



,MODE=[IBC] 



[■|]['|] 



J 



Name Field 

name 

specifies the name of the line. This 
name is used as a parameter in the 
SHOW command to request error informa- 
tion about the line. 

Operand Field 

DDLINE=ddname 

is the name specified in the DD state- 
ment defining the line (or line 
group) . The DD statement defining the 
line must be included in the cataloged 
procedure required for RJE (see Cata- 
loged Procedures for RJE) . 

DDSYS IN=ddname 

is the name of the DD statement defin- 
ing the SYSIN data set for the line. 
This DD statement must also be part of 
the cataloged procedure for RJE. 

RLN=1 

RLN=integer 

specifies the relative line number of 
this line within the line group. If 
this keyword parameter is omitted, 
RLN=1 is assumed. 



LERB=j 




integer 2 

integer.," 
5 



specifies the various threshold 
values. If an error threshold is 
reached before the transmission 
threshold, a message containing line 
error information is displayed to the 
central operator. If no error counter 
reaches its threshold value before 
this number of transmissions have 
occurred, the current values of all 
counters are added to their respective 
accumulators, and the counters are 
reset to zero. These accumulator 
values may be displayed with the com- 
mand: SHOW LERB, linename (see Cen- 
tral Commands) . The allowable values 
are integers 1-255 inclusive. The 
underlined value is assumed for any 
parameter omitted. 

Integer — transmission threshold 
Integer 2 — data check threshold 
Integer 3 — lost data threshold 
Integer* — nontext time-out 
threshold 

ID= (type, {2780 or 1 130, chars, termid} ,.. .) 
specifies type of remote station, 
device type, the polling character (s) fl 
and name of the work station on a mul- 
tidrop line and creates the polling 
list. The type operand specifies the 
decimal name of the device; for 
example, 2780 or 1130. The chars 
value is the EBCDIC hexadecimal equiv- 
alent of the polling character for the 
work station. The termid value is the 
name of the work station specified in 
the RJETERM macro instruction. If 
priority is to be given to a multi- 
dropped work station, its chars, ter- 
mid values are repeated in the sub- 
parameter list. 

M0DE=([IBC] ,[_bJLbJ) 

IBC (Intermediate Block Check) speci- 
fies that the transmission control 
unit will recognize the intermediate 
block-check character and perform 
block checking without turning the 
line around. If this suboperand is 
omitted intermediate block checking is 
not performed. 

A specifies that communications are 
to be through the Dual Communica- 
tions Interface A of the 2701 Data 
Adapter Unit. 

B specifies that communications are 
to be through the Dual Communica- 
tions Interface B of the 2701 Data 
Adapter Unit. The 2701 must have 
the dual interface feature in order 
to code B. If this suboperand is 
omitted, A is assumed. 



1 The 2780 has two polling characters and 
the 1130 has one. 
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A specifies that transmission will be 
in code A for 2701 Data Adapter 
Unit Dual Code Feature. 

B specifies that transmission will be 
in code B for 2701 Data Adapter 
Unit Dual Code Feature. 

If this suboperand is omitted, A is 
assumed. 

Programmer's Note ; If the trans- 
mission control unit is a 2703, the 
last two suboperands A, A must be 
omitted. B B 



Name Field 

name 

assigns the RJE symbolic name to the 
work station. This name, called the 
termid, identifies the work station to 
RJE. The work station is referred to 
by the termid rather than by its 
machine address. The termid is used 
in logically attaching the work sta- 
tion to the RJE system, in routing 
messages to the work station, and in 
retrieving information for the work 
station. 

Operand Field 



i t — r 1 

| Name | Operation | Operand I 

LINE 2 | RJELINE | DDLINE=LINEGRP4 , RLN=2 , * | 

| | LERB (,,10), DDSYSIN= | 

| J INPUT42, *j 

| |ID=(2780,E8,NYC,E7,LA,E8,| 

| J NYC, E9, CHI) j 

Figure 8. Example of RJELINE Macro 
Instruction 



TYPE=2780 

TYPE=CPU 

TYPE=1130 

identifies the type of work station as 
either a 2780 (IBM 2780 Data Transmis- 
sion Terminal) or, a CPU (an IBM com- 
puter with a binary synchronous com- 
munication adapter) , or an 1130 (IBM 
1130 computing system) . If the param- 
eter is omitted, the work station is 
assumed to be a 2780. 



Example ; Figure 8 shows the RJELINE macro 
instruction describing a multidrop line, 
named LINE2, with three attached 2780 work 
stations. The line is defined by DD state- 
ment LINEGRP4 and is the second line 
defined in the line group. The SYSIN data 
set is defined with DD statement INPUT42. 
The installation desires that an error mes- 
sage be displayed to the operator if 10 
lost data errors occur before 255 transmis- 
sions. The other assumed threshold values 
are satisfactory. The attached work sta- 
tions are named LA, NYC, and CHI and have 
the respective polling characters X, Y, and 
Z. Priority is to be given to work station 
NYC. 

RJETERM - DESCRIBE A WORK STATION 

The RJETERM macro is used to describe 
each work station to the RJE system. One 
macro instruction must be specified for 
each work station to be supported by RJE. 



j Name j Operation | Operand 
Y + +- 



I 
-I 



name I RJETERM 



L 



TYPE=2780 

TYPE=CPU 

TYPE=1130 



, PUNCH=YES 
, PUNCH=NO 

,PRTSZ=120 
,PRTSZ=132 
,PRTSZ=144 

[,ID=chars] 



j 



PUNCH=NO 

PUNCH=YES 

specifies whether a card punch is 
available at the work station. (A 
punch is required at the remote 
S/360.) If the parameter is omitted, 
a card punch is assumed. 

PRTSZ=120 

PRTSZ=132 

PRTSZ=144 

specifies the length of the print line 
at the work station. A print line of 
120 characters is assumed if the 
parameter is omitted. 

ID=chars 

if specified, indicates that the work 
station is connected to the RJE system 
via a multipoint line. The ID keyword 
value is the EBCDIC hexadecimal equiv- 
alent of the addressing character for 
the work station. For example, if the 
addressing character is the letter A, 
the ID keyword is coded as ID=C1 since 
C1 is the EBCDIC hexadecimal equiv- 
alent of A. Valid addressing charac- 
ters for 2780 work stations are alpha- 
betic. This keyword is not coded if 
the work station is connected via a 
point-to-point or switched line. 

Examples ; The RJETERM macro is coded 
for an IBM 2780 Data Transmission Ter- 
minal, Model 1 (punch and printer) 
with a 120 character print line con- 
nected via a switched line. The ter- 
mid, that is, the name which identi- 
fies the work station to the RJE sys- 
tem, is RALEIGH. 
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j RALEIGH | RJETERM | no operand required j 

If the same work station is connected 
via a multidrop line instead of a 
switched line, and its addressing 
character is the letter A, the macro 
is coded: 



j RALEIGH | RJETERM | 
L _J J 



ID=C1 






If the work station is an IBM System/ 
360 Model 30 with an attached printer 
having a 132-character print line, and 
the termid is to be Atlanta, the pro- 
grammer would code: 



the user directory during the macro 
expansion. 

Programmer's Note : The user id and 
protection key must contain only 
alphameric characters. These are A-Z, 
0-9, $, # and . Also, they each must 
be three characters long. 

Example : The projected number of 
userid-key assignments for the system 
is 20, but only 5 userid-key pairs 
have been specified. The following 
macro may be specified. 



r t t~i 

|RJEUSER|20,HYE,123,AND,12$,LOW, |X| 
| |la#,PDQ,444,LRM,111 | | 



I T T " 1 

j ATLANTA j RJETERM j TYPE=CPU,PRTSZ=132 j 
I I X J 



RJETABL - FURNISH EXIT, SYSOUT, AND REMOTE 
JOB INFORMATION 



RJEUSER - DEFINE THE USER DIRECTORY 

The RJEUSER macro allows each installa- 
tion to tailor the RJE user directory to 
its own needs. When the central system is 
assembled, each installation must indicate 
the maximum number of users with access to 
the RJE system. In addition, RJE user 
identification (userid) and protection 
(key) assignments may be made at this time. 
If the userid and key assignments are 
incomplete, the central operator can add to 
them dynamically by command if space is 
available in the directory. A new assembly 
is not necessary to add users unless the 
directory is full. If a projected figure 
is used, rather than one which satisfies 
only immediate requirements, unnecessary 
RJE assemblies can be avoided. 

r t t t 

| Name | Operation | Operand | 

| [name] | RJEUSER j integer | 

I I | [, {userid, key} ,...] j 

Operand Field 

integer 

specifies the maximum number of 
userid-protection key assignments to 
be made. This number should be the 
projected number of such assignments 
for the system. The integer value 
specified must be from 1 to 999 
inclusive. 

userid, key 

designates the user identification 
(userid) and protection (key) 
assigned. The userid and key are 
specified as a pair and are entered in 



The RJETABL macro is used to specify: 

1 . The maximum number of remote jobs 
which may reside in the central system 
at a given time; 

2. The SYSOUT class assignments for 
remote job output and the class 
reserved for RJE at the central 
installation ; 

3. Whether the provided user exits are 
desired. 

The macro creates the necessary control 
blocks to handle the remote jobs and pro- 
vides the desired exits. 



Operation j Operand 



r 

| Name 

I 1 

[name] I RJETABL 



4 _ .j 

| JOB=integer 

j , SYSPRT=char 

j ,SYSPCH=char 

j , SYSUSER=char 

| , SYSRJE=char 

| [,JOBCARD=routine name] 

j [, JOBACK=routine name;] 

j [,COMMERR=routine name] 

| r, BUFN0=1 1 

d 



. BUFNO=integerJ 






Operand Field 

JOB=integer 

specifies the maximum number of remote 
jobs which may reside in the central 
system concurrently. When this Vctlue 
is reached, no more remote jobs are 
accepted until other remote jobs are 
removed from the system. The intc;ger 
value specified must be from 1 to 999 
inclusive. 
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SYSPRT=char 

identifies a SYSOUT class for printed 
output at the central installation. 
All SYSOUT data sets of remotely sub- 
mitted jobs must use this character 
for printed output. 



SYSPCH=char 

identifies a SYSOUT class for punched 
output at the central installation. 
All SYSOUT data sets of remotely sub- 
mitted jobs must use this character 
for punched output. 

SYSUSER=char 

identifies the SYSOUT class for output 
to be given to a user- written routine 
at a remote System/360 operating in 
the Remote Job Entry Work Station Pro- 
gram. All SYSOUT data sets of remote- 
ly submitted jobs must use this 
character for output to be directed to 
the user's routine. 

SYSRJE=char 

identifies the SYSOUT class assigned 
to RJE at the central installation. 
This class must be reserved for the 
use of RJE only. If locally submitted 
jobs place output in this class, the 
output is deleted. It is recommended 
that the user assign the RJE SYSOUT 
class in the range of 0-9. 

Programmer ' s Not e ; If a user speci- 
fies SYSOUT data sets other than those 
for printed, punched, or user-exit 
output, the data set returned to the 
work station is printed. If user-exit 
output is returned to a work station 
that has no user exit, the output is 
printed. 

JOBCARD=routine name 

is the name of the user-written rou- 
tine which examines a remotely sub- 
mitted JOB statement, including con- 
tinuation cards. This routine name 
identifies the entry point of the rou- 
tine which is given control when a JOB 
statement is received. 

JOBACK=routine name 

is the name of the user-written rou- 
tine which may examine and modify the 
job acknowledgment message. This rou- 
tine name identifies the entry point 
of the routine which is given control 
before the job acknowledgment is sent. 

COMMERR=routine name 

is the name of the user's routine 
which examines communications errors 
encountered during RJE operation. The 
routine name identifies the entry 
point of the routine which is given 
control after the error is found. 



BUFNO=integer 

specifies the maximum number of cen- 
tral commands that may be queued for 
processing at one time. If this value 
is exceeded, all additional central 
commands are rejected and must be 
resubmitted after the pending commands 
are processed. The integer specified 
must be from 1 to 100 inclusive. If 
this parameter is omitted 1 is 
assumed. 



GENERATION OF THE RJE LOAD MODULE AND 
INITIALIZE PROGRAM 

After the completion of stage 2 of 
Operating System generation, the user must 
execute the necessary assemblies and link 
edits to create the RJE resident load 
module, IHKRJBGN, and the program which 
initializes the RJE control tables, IHKIN- 
TAB. (The program which initializes the 
broadcast-message data sets, IHKCDBMI, does 
not depend upon the RJE macro definitions 
and was prepared for execution at system 
generation time.) 

Four steps are required to accomplish 
the above. One additional step is required 
for each of the three user exits to be 
included in the system. Figure 9 shows the 
JCL and linkage editor control cards 
required for these steps. Following is a 
description of each step. 

STEP 1 - assembles the RJE macros and 

places the object module produced 
(IHKAARJE) in a temporary data set 
(RJETEMP) from which it will be 
link-edited to SYS1 .TELCMLIB in a 
later step. 

STEP 2 - is necessary if the JOBCARD user 

exit is to be included. The user- 
written routine is assembled and 
placed in RJETEMP with the name 
specified in the RJETABL macro in 
STEP 1. 

STEP 3 - is necessary if the JOBACK user 

exit is to be included. The user- 
written routine is assembled and 
placed in RJETEMP with the name 
specified in the RJETABL macro in 
STEP 1 . 

STEP 4 - is necessary if the COMMERR user 

exit is to be included. The user- 
written routine is assembled and 
placed in RJETEMP with the name 
specified in the RJETABL macro in 
STEP 1. 

STEP 5 - linkage editing of four modules 
created in the preceding steps 
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from RJETEMP to SYS1 .TELCMLIB is 
accomplished. 

Note : The following labels will be flagged 
as unresolved at the end of this step, 

IHKABLSD 
IHKAASTO 
IHKCMDSV 
IHKWTRSV 

and the names assigned to the user exits if 
any are included. These unresolved link- 
ages do not affect the generation of the 
RJE system. 

STEP 6 - (At this point all modules needed 
in this step are on SYS1. 
TELCMLIB.) This step link edits 
all preassembled RJE resident 
modules and the output of STEPS 1 , 
2 , 3 , and 4 to create the RJE 
resident load module, IHKRJBGN, 
and places it on SYS1.LINKLIB. 
The linkage of all resident 
modules is triggered by including 
(by use of the INCLUDE card) the 
RJE modules IHKAARJE and IHKABLST. 
The module IHKAARJE, generated 
from the RJE assembly macros, con- 
tains external references by which 
the linkage editor includes all 
user-exit routines. The preas- 
sembled resident module IHKABLST 



contains external references by 
which all other preassembled resi- 
dent modules are also included. 
NCAL must not be specified. 

STEP 7 - creates the program for initializ- 
ing the RJE control tables. 
IHKAARJE and IHKCDINI are included 
from SYS 1. TELCMLIB. The resulting 
program is placed on SYS1.LINKLIB 
and named IHKINTAB with entry 
point IHKCDINI. NCAL must be 
specified. 

Note ; The following labels will be flagged 
as unresolved at the end of this step: 

IHKABLSD 
IHKAASTO 
IHKCMDSV 
IHKWTRSV 

and the names assigned to the user exits if 
any are included. These unresolved link- 
ages do not affect the generation of the 
RJE system. 

Note : If any one of the RJE macro specifi- 
cations is changed after the link-edits 
have been completed, STEPS 1, 5, 6, and 7 
must be redone. If any of the user-exit 
routines is changed, the step (s) involved 
(i.e., 2, 3, 4) plus steps 5 and 6 must be 
redone. 
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SAMPLE JCL 



//RJEASLE 



JOB | (JOB card parameters) 
+ 

EXEC I PGM=IEUASM 



//STEP1 
//SYSLIB 



+ 

DD | DSNAME=SYS1.MACLIB,DISP=OLD 
+ 



4 — 

I 

4 — 

I 
4 — 

I 
4 

I 
4 

I 
4 

I * 
4 

I 
4 

I 
4 

I 

I 

I 
4 



//SYSUT1 
//SYSUT2 



Parameters defining the assembly utility data sets 



//SYSUT3 

//SYSPRINT 



4 

| SYSOUT=A 



DD 
DD 



//SYSPUNCH 



DSNAME=RJETEMP (IHKAARJE) ,DISP= (NEW, KEEP) 



// 



SPACE= (TRK, (10,1,2)) ,UNIT=23xx,VOLUME=SER=xxxxxx 



//SYSIN 



DD 



RJE macro statements 



/* 



//STEP2 
//SYSLIB 



EXEC 



PGM=IEUASM 



DD | Parameters defining macro library 
+ 



//SYSUT1 



//SYSUT2 



Parameters defining the assembly utility data sets 



//SYSUT3 
//SYSPRINT 



DD | SYSOUT=A 
+ 

DD | DSNAME=RJETEMP (name of user exit routine) , 



//SYSPUNCH 

// 

//SYSIN 



| DISP=OLD,VOLUME=REF=* . STEP1 . SYSPUNCH 

4 

i * 



DD 



input for user exit routine 



4 

I 
4 



/* 



//STEP3 format as in STEP 2 for second user exit routine 

t r 



/* 



//STEP4 format as in STEP2 for third user exit routine 



/* 



//STEP5 



| EXEC | PGM=LINKEDIT,PARM= (XREF,LIST,DC,NCAL,LET) 



//SYSLMOD | DD | DSNAME=SYS1 .TELCMLIB, DISP=OLD 

L JL I 

Figure 9. Sample Job Control Language (Part 1 of 3) 
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input for user exit routine (continued) 



//SYSLIB 



DD 



DSNAME=RJETEMP,DISP= (OLD, DELETE) , 



// 



VOLUME=REF=* . STEP 1 . SYSPUNCH 



4 — ^ 



//SYSUT1 



DD 



Parameters defining the utility data set 



//SYSPRINT 



DD 



SYSOUT=A 



//SYSLIN 



DD 



INCLUDE SYSLIB (IHKAARJE) 



4 "I 



NAME IHKAARJE (R) 

INCLUDE SYSLIB (name of first user exit) 



4 1 



NAME name of first user exit (R) 
INCLUDE SYSLIB (name of second user exit) 



NAME name of second user exit (R) 
INCLUDE SYSLIB (name of third user exit) 



NAME 



name of third user exit (R) 



4 1 



//STEP 6 



EXEC j PGM=LINKEDIT,PARM= (XREF r LIST f DC) 



//SYSLMOD 



DD 
DD 



DSNAME=SYS1 . LINKLIB,DISP=OLD 



4 — ^ 



//SYSLIB 



| DSNAME=SYS1.TELCMLIB,DISP=0LD 



-+ — ^ 



//SYSUT1 



DD | Parameters defining the utility data set 
+ 

DD | SYSOUT=A 
+ 

DD I * 



//SYSPRINT 



//SYSLIN 



4 — 1 



INCLUDE SYSLIB (IHKAARJE) 



4 — ^ 



INCLUDE SYSLIB (IHKABLST) 

ENTRY IHKRJBGN 



4 — H 



NAME IHKRJBGN (R) 

T 



/* 



4 — ^ 



//STEP7 



EXEC 



PGM=LINKEDIT r PARM= (XREF, LIST, DC, NCAL, LET) 



//SYSLIB 



DD 



DSNAME=SYS1 .TELCMLIB,DISP=OLD 



4 — H 



//SYSLMOD 



DD 



DSNAME=SYS1 . LINKLIB,DISP=OLD 



//SYSUT1 



DD 



Parameters defining the utility data set 



//SYSPRINT 



DD 



SYSOUT=A 



y 

//SYSLIN 

L X.. 

Figure 9. Sample 



DD 
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input for user-exit routine (continued) 

INCLUDE SYSLIB (IHKAARJE) 

INCLUDE SYSLIB (IHKCDINI) 
+ 



/* 

Notes: 



ENTRY 
NAME 



IHKCDINI 
IHKINTAB (R) 



I _ 

\ I 



1. The SPACE parameter for the SYSPUNCH data set in STEP1 is more than adequate for j 
assembled RJE macros. This parameter should be altered as necessary to provide j 
sufficient space for the user-written routines. | 

I 

2. This seven-step job requires 120 records on SYS1 .SYSJOBQE reserved for the initia- | 
tor. If a smaller amount was specified at system generation (60 records is! the j 
default) , the number should be changed with an R00 r , 120" response to the message j 
IEF432A SPECIFY JOB QUEUE PARAMETERS at IPL. 



Figure 9. Sample Job Control Language (Part 3 of 3) 



INITIALIZE RJE TABLE AND MESSAGE DATA SETS 

This utility program prepares a new and 
initialized copy of the RJE control tables 
and/or the broadcast-message data sets on 
disk. 



There are 2 groups of RJE data sets 
requiring initialization. 

Group X contains the RJE control tables . 

These ares 



SYS1.IHKFSTB 
SYS1.IHKJEDTB 
SYS1.IHKUDRTB 
SYS 1 . IHKTDRTB 



Fastable (jobs) 
Jed table (jobs extended) 
User directory 
Terminal directory 



Group 2 contains the BRDCST and MSG 
texts and their directories. 



These ares 

SYS 1 . IHKTXTTB 
SYS1.IHKMSGSL 
SYS 1 . IHKBRDSL 



BRDCST-MSG texts 
MSG directory 
BRDCST directory 



Before the RJE system is used, both 
groups of data sets must be initialized. 
After both data sets have been initialized, 
it is possible to reinitialize either group 
independent of the other. This allows 
changing the size of the control tables in 
Group 1 without altering the Group 2 tables 
(the Group 2 table size is fixed) or moving 
either of the tables to a different posi- 
tion on the DASD. See Note. 



Depending upon the requirements, 
utility includes any or all of the 
following: 



the 



STEP 1 a) a SCRATCH for the data sets 
involved. ! 

b) an UNCATLG for each data iset if 
necessary. 



STEP 2 - initialization of the control 
tables data sets. 

STEP 3 - initialization of broadcast- 
message data sets. 



SCRATCHING THE DATA SETS 

IEHPROGM, with the SCRATCH statement, is 
used to scratch the old data sets yhen 
reinitializing. It is not necessarjy at 
initial creation of the data sets, j For 
additional requirements to use IEHPROGM see 
IBM System/360 Operating System: Utili- 



ties , Form C28-6586 

I T T 1 1 

| Name | Operation | Operand | 

| [name] | SCRATCH | DSNAME=name , | 

j j |VOL=23xx=serial number, | 

j | | PURGE | 

Group 1 and/or 2 may be scratched. 
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UNCATALOGING THE DATA SETS 

IEHPROGM, with the UNCATLG statement, is 
used to uncatalog data sets. This is used 
only when the unit or volume is being 
changed for either group of data sets- The 
data sets must be scratched before 
reinitialization. 



j Name j Operation j Operand 



| [name] | UNCATLG |DSNAME=name 

J - L 



J 



INITIALIZING THE RJE CONTROL TABLES 

IHKINTAB is used to initialize the con- 
trol tables. In addition to the EXEC 
statement, the input stream for IHKINTAB 
includes : 

• A DD statement named SYSABEND specifying 
an output device in case of an abnormal 
end. 

• A DD statement for each of the four data 
sets, containing the tables, in the fol- 
lowing form: 



// ddname | DD | 

// | | 
„__ + + 

// | | 



DSNAME=name,DISP= (NEW,CATLG) , 



SPACE=(a, (b,c)) ,UNIT=23xx 
VOLUME=SER=xxxxxx,DCB= (DSORG=DA) 

ddname=IHKFSTDD, IHKJEDDD, IHKUDRDD , IHKTDRDD 

SPACE (a, (b,c)) 



x 



a) SYS1.IHKFSTB 
SYS1.IHKJEDTB 
SYS1 .IHKUDRTB 
SYS1.IHKTDRTB 

b) SYS1.IHKFSTB 
SYS1.IHKJEDTB 
SYS 1. IHKUDRTB 
SYS1.IHKTDRTB 

c) c=5 



a=24 

a=98 

a=18 

a=68 
see JOB=integer 
see JOB=integer 
see maxuser- integer 
see RJETERM 



b=integer+ 1 

b=integer+ 1 

b=integer 

b=no. of RJETERMs 






INITIALIZING THE BROADCAST-MESSAGE DATA 
SETS 



IHKCDBMI is used to initialize the 
broadcast and message data sets. In addi- 
tion to the EXEC statement, the input 
stream for IHKCDBMI includes: 



A DD statement named SYSABEND specifying 
an output device in case of an abnormal 
end of job. 

A DD statement for each of the three 
data sets associated with the broadcast 
messages and delayed messages as 
described below: 



Y— 



//IHKTXTDD 
// 



-+ 






// 

//IHKMSGDD 

// 

// 

//IHKBRDDD 









// 



// 



SPACE=(60, (251,20)) ,UNIT=xxxx, 



T 1 

I x 

I x 

+— 

I 



DD | DSNAME=SYS 1 . IHKTXTTB , DI SP= (NEW , CATLG) , 

+ 

I 

| VOLUME=SER=XXXXXX,DCB= (DS0RG=DA) 

DD | DSNAME=SYS1.IHKMSGSL,DISP= (NEW, CATLG) , | X 

| SPACE=(750, (1,1) ) ,UNIT=xxxx, | x 

| VOLUME=SER=XXXXXX 

DD | DSNAME=SYS1.IHKBRDSL,DISP= (NEW, CATLG) , | x 

+ ,, 

I x 



SPACE= (400, (1,1)) ,UNIT=xxxx, 






VOLUME=SER=xxxxxx 
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Note ; A change in the size of the data set macros is changed, IHKCDBMI should 



is made by a change in the macro definition 
of IHKAARJE. A change is necessary to 
alter the provision for number of jobs, 
users, terminals, or lines in the system. 

If any change is made to decrease the 
number of terminals, or if the order of 
terminals as specified in the RJETERM 



executed. Otherwise, delayed messages 



existing prior to the RJE assembly 
sent to the wrong terminal. 



be 



may be 



Caution ; When IHKCDBMI is executed^ all 
delayed messages and broadcast messjages are 
lost. 




SAMPLE CODING FORM 






PGM=IEHPROGM 
SYSOUT=A 



V0LUME=SER=1 11111 ,DISP=OLD,UNIT=23 1 1 



I 



DSNAME=SYS 1 . IHKFSTB, VOL=23 1 1=1 



DSNAME=SYS 1 . IHKJEDTB , V0L=2 311 = 



DSNAME=SYS 1 . IHKUDRTB , V0L=2 311 = 
DSNAME=SYS 1 . IHKTDRTB , V0L=2 311 = 
DSNAME=SYS 1 . IHKTXTTB , V0L=2 311 = 
DSNAME=SYS1 . IHKMSGSL, VOL=231 1= 
DSNAME=SYS 1 . IHKBRDSL, VOL=23 1 1= 



1 , PURGE 
11, PURGE 
1 1 , PURGE 
1 1 , PURGE 
1 1 , PURGE 



I 






11, PURGE 



11, PURGE 



I 
-+- 



4- 



-+- 
I 



PGM=IHKINTAB 

SYSOUT=A 

DSNAME=SYS1. IHKFSTB, DISP= (NEW,CATLG) , 

SPACE=(24, (11,5)) ,UNIT=2311, 

VOLUME=SER= 111111, DCB=DSORG=DA 

DSNAME=SYS1 .IHKJEDTB, DISP= (NEW,CATLG) , 

SPACE=(98, (11,5)) ,UNIT=2311, 



I 

I 

I 

I 
-+- 
1 I 

! I 






V0LUME=SER=1 11111, DCB=DSORG=DA 
DSNAME=SYS 1 . IHKUDRTB , DI SP= (NEW , CATLG) , 
SPACE=(18, (15,5)) ,UNIT=2311, 
V0LUME=SER=1 11111 , DCB=DSORG=DA 
DSNAME=SYS 1 . IHKTDRTB , DI SP= (NEW , CATLG) , 
SPACE=(68, (15,5)) ,UNIT=2311, 



i I 
iH~ 
i 

H- 
! I 

f+ 

; I 
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h- 



I + 






I- 



SAMPLE CODING FORM (Continued) 



+- 



27 
28 
29 
30 
31 






32, 

33 

34, 









35 
36 
37 
38 



J- —4 



// 

//STEP3 



"T 



//SYSABEND 
//IHKTXTDD 
// 









// 

//IHKMSGDD 
// 



-+- 

I 
-+- 

I 
-+- 

I 

+- 



| VOLUME=SEP -111111, DCB=DSORG=DA 

EXEC | PGM=IHKOJBMI 

DD | SYSOUT=A 

DD | DSNAME=SYS1.IHKTXTTB,DISP= (NEW,CATLG) , 



+- 



j SPACE= (60, (251,20)) ,UNIT=2311, 



H- 



// 

//IHKBRDDD 



H-— 



| VOLUME=SER= 111111, DCB=DSORG=DA 
DD | DSNAME=SYS 1 . IHKMSGSL , DI SP= (NEW , CATLG) , 
| SPACE=(750, (1,1)) ,UNIT=2311, 



// 
// 



I 
I 



DD 



| VOLUME=SER= 111111 

| nSNAME^SYS 1 . IHKBRDSL, DISP= (NEW, CATLG) , 

| SPACE= (*♦(■"», (1,1)) ,UNIT=2311, 

| VOLUME=SER= 111111 









INITIALIZATION OF ALL DATA SETS ON SAME 
UNIT 



STATEMENT 

1 . Job card 

2. Execute Utility program (IEHPROGM) 
from library 

3. Define output device for output 
messages 

4. Indicate permanently mounted 
volume 

5. Begin input stream 

6-9. Scratch RJE control tables data 
sets 

10-12. Scratch broadcast-message data 
sets 

13. End of SYSIN 

14. Execute program to initialize RJE 
Control Tables data sets 

15. Define output device for abnormal 
end output 

16-27. DD statements defining RJE control 
tables data sets. (Allocation for 
10 jobs in the system at a time, 
15 users, and 15 terminals) 



28. 

29. 

30-38. 



Execute program to initialize 
broadcast-message data sets 

Define output device for abnormal 
end output 

DD statements defining broadcast- 
message data sets. 



CATALOGED PROCEDURES FOR RJE 

RJE operation reguires one or more pro- 
cedures cataloged in SYS 1 . PROCLIB . One of 
these procedures must be referenced when 
the RJE task is started and stopped at the 
central system. This procedure contains 
those JCL statements required by the 
Operating System and the central RJE 
system. 

Example : Figure 10 shows a procedure 
illustrating these statements and the 
descriptions keyed to them. 



In the first statement, RJE names the 
procedure and is used as the procedure name 
on the START command at startup. IHKRJBGN 
must be specified as the program name on 
all RJE procedures. (See Appendix B for 
algorithm to determine size of the RJE 
region.) 

Statements 1 through 4 are required by 
the routine which initiates system tasks 
and must be coded as shown. 
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Statements 5 through 11 are required for 
RJE direct access storage tables and must 
be coded as shown. 



Statements 12 through 15 are the DD 
statements for the SYSIN data sets. This 
procedure assumes a four line network. One 
SYSIN DD statement is included for each 
line. The xxxxxx is the serial number of 
the volume reserved for SYSIN data. The 
23xx represents any OS supported direct 
access device. The space for any one SYSIN 
data set is controlled by the value of the 
secondary allocation parameter in the SPACE 
parameter (20 in this example) . The system 
provides the secondary allocation fifteen 
times. Depending upon the requirements of 
the installation, the secondary allocation 
parameter may be increased or decreased. 
The block size must be 80 r 160, 240, 320, 
or 400 bytes (400 in this example) . If no 
block size is specified, 80 is assumed. 
The name specified for the DD statement 
must be the name designated in the RJELINE 
assembly macro. 



Statements 16 and 17 are the DD state- 
ments for the line. This example describes 
two line groups, each including two lines. 
The UNIT parameter contains the physical 
address of the lines. 



Note ; The user must be aware of the sig- 
nificance of specifying blocked SYSIN data 
in the RJE procedure, and must make sure 
that the BLKSIZE and LRECL parameters in 
the Data Control Block (DCB) of his problem 
program are consistent with the SYSIN 
blocking. The simplest way to assure this 
is to omit these parameters from the DCB of 
the program. The Queued Sequential Access 
Method (QSAM) will pick up these parameters 
from the data set header and deblock the 
data. If the program is using the Basic 
Sequential Access Method (BSAM) , the pro- 
gram must check the BLKSIZE and LRECL in 
the DCB after OPEN and must do its own 
deblocking. 



USER EXITS 



Remote Job Entry provides three exits in 
•the central system allowing the user to 
insert special processing routines. These 
routines must save registers when they are 
entered. The address of an 18 word save 
area for this purpose is passed in register 
13. When the routines finish processing 
they restore the registers to their entry 
values and return control to the address in 
register 14. 



JOBCARD EXIT 

The JOBCARD user exit allows a u>er- 
written program to examine each reniotely 
submitted JOB statement and to alter its 
operand field. Neither the jobnamej nor the 
operation field can be changed. Th[e 
address of the JOB card is passed tlo the 
user routine in register 1 . JOB continua- 
tion cards are passed to the user rloutine 
in the same way by subsequent entries. 
Control must be returned to the sysjtem 
before further processing of the job entry. 



COMMERR EXIT 

The COMMERR user exit allows a 
written program to assume control 
has unsuccessfully exhausted its 
following a line error. When the 
control via the exit, register 1 
the address of the Data Event 
(DECB) associated with the line 



user- 
alfter RJE 
.es 
;er gets 



re i tri< 
xis( 



contains 



Control 



The user may issue any BTAM ma 
(except OPEN and CLOSE) in this 
associated WAIT macro instruction 
degrades the performance of the RJE 
The user-written routine also can 
gate the BTAM line error block and 
appropriate action. If a 
station is permanently in error, 
macro instructions may be issued tc 
that work station in the polling 
addressing lists. If entries are 
they are restored to the list when 
central system is restarted with 
command. 



exit. The 
h|owever , 

system, 
interro- 
take 
multidro^ped work 

cIgntry 

skip 
arid 
sjkipped, 
the 
the START 



Block 
error. 



Control returns to the system after the 
error is examined and desired action is 
taken. 



JOBACK EXIT 

The JOBACK user exit allows a user- 
written program to examine and alter the 
RJE job acknowledgment message (message 
IHK117I) before it is sent to the user. 
This routine also may construct its own 
message containing up to 59 characters. 
The additional message is sent following 
the RJE constructed acknowledgment. 



additional 



The address of the RJE constructed 
sage is passed to the routine in 
1. The JOBACK routine must provide 
59-byte buffer to construct an 
message. If no additional message 
structed, the routine returns 
the system with zero in register 1. 
additional message is constructed 
routine, the address of the message 
passed in register 1 when control 
to the system. 



reqister 



contrlol 



% 
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mes- 

ter 

its own 



is con- 
to 
If an 
the 
is 
rteturns 



1. 1 //RJE | EXEC | PGM=IHKRJBGN,REGION=80K 

2. | //IEFDER | DD | DUMMY 

3. | //IEFDATA | DD | UNIT=23xx,VOLUME=SER=XXXXXX, 
I // || SPACE= (80, (500,500) , RLSE , CONTIG) , 



| // || DCB=(BUFNO=2,LRECL=80 r BLKSIZE=80,I yCFM=F r BUFL=80) 



— T— 

-+- 

-+- 
+- 



4. | //IEFPDSI | DD | DSNAME=SYS1.PR0CLIB,DISP= (OLD, KEEP) 

5. J //IHKFSTDD | DD | DSNAME=SYS1 .IHKFSTB,DISP=OLD,DCB=DSORG=DA 



I 
I 

— h 
x I 

.! 

x I 

— ^ 

! 

- — ^ 






6. J //IHKJEDDD | DD | DSNAME=SYS1 ,IHKJEDTB,DISP=OLD,DCB=DSORG=DA 



8. 






//IHKTXTDD | DD | DSNAME=SYS1 .IHKTXTTB,DISP=OLD,DCB=DSORG=DA 
//IHKMSGDD | DD | DSNAME=SYS1 ,IHKMSGSL,DISP=OLD 



9, 
10, 
11- 
12, 



13. 



h 

//DUMDD1 | DD | DISP= (OLD, KEEP) , 

// | | VOLUME=SER=XXXXXX,SPACE= (TRK, (5,20) ) , 

// | | UNIT=23XX,DCB=BLKSIZE=400 

//DUMDD^ | DD | DISP= (OLD, KEEP) , 



16. 



17. 



//IHKUDRDD j DD j DSNAME=SYS1 .IHKUDRTB,DISP=OLD,DCB=DSORG=DA 
//IHKTDRDD | DD | DSNAME=SYS1 ,IHKTDRTB,DISP=OLD,DCB=DSORG=DA 



+- 



— + +-" 



i 

I 

I 

h 



— +— 






//IHKBRDDD | DD | DSNAME=SYS1 . IHKBRDSL,DISP=OLD 






// | | VOLUME=SER=XXXXXX , SPACE= (TRK , (5,20)) , 

// I | UNIT=23XX,DCB=BLKSIZE=400 






14. | //DUMDD3 | DD | DISP= (OLD, KEEP) , 
// | | VOLUME=SER=XXXXXX,SPACE= (TRK, (5,20)) , 
// | | UNIT=23XX,DCB=BLKSIZE=400 

15. | //DUMDD4 | DD | DISP= (OLD, KEEP) , 












// | | VOLUME=SER=XXXXXX,SPACE= (TRK, (5,20)) , 

// | | UNIT=23XX,DCB=BLKSIZE=400 

//CPUGRP | DD | UNIT=0BA 

// | DD | UNIT=0BB 

//A2780GRP | DD | UNIT=0CA 

// | DD | UNIT=0CB 

J. X 















Figure 10. Example of RJE Cataloged Procedure 
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COMMUNICATION SERVICEABILITY FACILITIES 



OPERATOR AWARENESS 



SYSTEM RESTART 



A BTAM system-to-operator message is 
displayed for the central operator whenever 
an irrecoverable communication error 
occurs. In addition, error counts for each 
line are displayed for the central opera- 
tor. For each line, BTAM keeps an error 
count for data check, for intervention 
required, and for nontext time-out. BTAM 
also records the number of transmissions 
occurring on the line. The user may speci- 
fy threshold values for these counters when 
the RJE support is assembled. If any one 
of the three error counters reaches its 
threshold count before the transmission 
threshold count is reached, a message is 
displayed for the central operator. This 
message identifies the line and gives all 
three error counts and the transmission 
count. After the message is displayed, the 
error counts and the transmission count are 
added to accumulators, and the counters 
reset to zero. The central operator may 
display the value of the accumulators at 
any time with the SHOW LERB command. The 
accumulators for one line or for every sup- 
ported line may be requested. These accu- 
mulators are reset to zero each time the 
central system starts up. 



Note: 



If the transmission count reaches 



its threshold count before any error count, 
the counters are added to the accumulators 
and reset to zero. No message is 
displayed. 



ERROR RECOVERY PROCEDURES 

When BTAM has exhausted its error re- 
tries at the central system, a permanent 
line error exists. BTAM posts the error to 
RJE and displays a message to the central 
operator. At an S/360 work station, when a 
permanent line error exists, a message is 
displayed for the remote operator; at a 
2780, an alarm is sounded. 

The remote operator procedures required 
after an irrecoverable error depend upon 
the remote work station and are described 
in detail in the sections on the individual 
work stations. In general they involve 
resubmitting only that portion of the 
remote input stream for which the central 
system has not returned a written 
acknowledgment . 

Note ; RJE does not inhibit any facility 
provided for error recovery in IBM binary 
synchronous communications system. 



A restart condition results whenj an 
irrecoverable error occurs at the central 
system requiring the supervisor to pe 
reloaded. 



The RJE system records each complete 
logical element (either a job entry or a 
work station command, see Figure 11] when 
it is received and returns a response ack- 
nowledging its receipt. After an unco- 
rrectable error, all acknowledged logical 
elements will be recovered by the central 
system. When the work station restarts the 
user must resubmit only the unacknowledged 
input . 



It is possible for an uncorrectable 
error to occur after a group of logjical 
elements are received, but before the ac- 
knowledgments are sent. To handle this, 
the central system returns any pending ac- 
knowledgments when RJE is restarted', and 
the work station becomes active. Fpllowing 
the acknowledgments, a message indicating 
that a restart occurred at the centjral sys- 
tem and that work station restart proce- 
dures are required, is sent. By checking 
the acknowledgments at restart time), the 
work station user determines what ijnput 
must be resubmitted. Any remote jops which 
are executing (as opposed to waiting) when 
the failure occurs are processed at} restart 
time, the same as locally submitted! jobs. 
That is, the remaining portion of tpe job 
is processed in the flush mode, and) all 
output, including the diagnostics asso- 
ciated with the flush mode processing, as 
well as any valid output generated jbefore 
the failure, is returned to the rembte work 
station. i 









I * * 


RJSTART 




I * * 


LOGON 


(comjxiands) 


I * * 


OUTPUT 




I * * 


JED 




| //NAME 


JOB 




| //STEP 


EXEC 




|//DD1 


DD 




| //DD2 


DD 


(jobj entry) 


|//SYSIN 


DD* 






LOGOFF 


(com 


nand) 


L 







.J 

Figure 11. Logical Elements of an JEnput 
Stream ! 
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CENTRAL RESTART PROCEDURE 

The procedure followed to restart RJE at 
the central system includes three steps: 



1. The condition causing the error is 
corrected; 

2. The operator reloads the supervisor; 

3. The operator issues the START command 
for RJE. 

These three steps restart the RJE sup- 
port in the central system. RJE provides 
the necessary information to the work sta- 
tions to ensure that no information is 
lost. 



WORK STATION RESTART PROCEDURE 

The restart procedure is initiated at a 
work station by submitting an RJSTART com- 
mand. After the work station has received 
all pending responses , the operator resub- 
mits only that input for which he has not 
received a response. 

The work station restart procedure after 
a central system failure is similar to the 
restart procedure after an irrecoverable 
line error. The primary difference is that 
after a system failure, an in-process out- 
put data set is written from the beginning 
rather than from the last valid block. The 
procedures for specific work stations are 
described in the sections on remote work 
stations. 
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SYSTEM/360 WORK STATION 



The IBM System/360 serves as an RJE sup- 
ported work station. The IBM System/360 
BOS/BPS Remote Job Entry Work Station Pro- 
gram is supplied for this function. This 
program operates in conjunction with the 
central system and observes the required 
RJE communication conventions. Either BOS 
or BPS may be used as a supervisor. 

Input submitted at the work station is 
transmitted to the central system. All 
JECL statements are sequence checked to 
reduce unproductive transmissions. Output 
directed to the work station is routed to a 
specified output device or passed to a 
user-written output routine via the user 
exit provided. The operator has the abili- 
ty to interrupt receipt of output. 



MACHINE AND DEVICE REQUIREMENTS 

A System/360 used as a work station 
requires at least 16K bytes of main storage 
and, in addition to the minimum configura- 
tion required by the BOS or BPS supervisor, 
a line printer, a card punch, and a 1052 
printer-keyboard are required also. The 
System/ 3 60 must be connected to a communi- 
cation line via an IBM 2701 Data Adapter 
Unit with Synchronous Data Adapter, Type 
II, equipped for EBCDIC transparent opera- 
tion. The dual communication interface 
special feature is supported. A user- 
written output routine is required for out- 
put operations on any other output device. 
To support Remote Job Entry operation with 
a user-written routine, a System/360 with 
at least 24K bytes of main storage is 
required. 



COMMUNICATION CONSIDERATIONS 

The System/360 work station communicates 
with the central system by point-to-point 
contention over either a switched or non- 
switched communications line. The 2701 
Data Adapter Unit provides the actual at- 
tachment of the work station to the line. 
All transmissions between the central sys- 
tem and a remote System/360 are in EBCDIC 
transparency. Communication with the 
central system proceeds in three modes: 
monitor, receive, and transmit. 

Monitor mode is entered from either 
transmit or receive mode. In the monitor 
mode, the work station is waiting for input 
from the line, card reader, or 
printer-keyboard . 



Receive mode is entered when the:: 



output available for the work stati 
receive mode, the work station read£ 
from the line. It continues reading 
the line until it receives an end-of 
indication from the central system 
the operator discontinues the output 
the end-of-data indication is received 
the operator intervenes to discontinue 
output, the station enters the monitor 
mode. 



e xs 
on. In 
output 
from 
-data 
6r until 
When 
or 
the 



Transmit mode is entered at work 



startup and when there is input ava 
at the work station. In transmit 
work station writes to the line. I 
tinues writing to the line until it 
complete job entry or encounters a 
end-of -file in the input stream 
logical end-of- file indication is r 
from the card reader, or a complete 
entry is transmitted, monitor mode 
entered to test for available output 
the central system. If output is 
able, it is received at this time. 



mode. 



station 
lable 
the 
con- 
sends a 
logical 
When a 
eceived 
job 
s 
from 
il- 



ava: 



Transmit mode will be reentered 
receiving an EOT from the central 
receive mode was entered after tr 
of a complete job entry. If receive 
was entered by an end-of -file indi 
operator intervention is required 
er transmit mode. 



to 



INPUT AT THE WORK STATION 

Input is accepted from the card Reader 
or a 1052 printer-keyboard. Acceptable 
input consists of job entries and work sta- 
tion commands. Work station commands other 
than the RJSTART command may be entered by 
either the card reader or the printer- 
keyboard. The RJSTART command must always 
be entered at the card reader. However, a 
correction of a previously entered command 
may be entered by either the card reader or 
the printer-keyboard. The only acceptable 
entries from the printer-keyboard are work 
station commands, other than RJSTART, and 
corrections to statements in error. A 
correction made at the printer-keyboard 
will replace the statement in error, 
However, if an error is caused by omission 
of a statement, the omitted statement may 
be entered from the printer-keyboard, but 
the statement which is replaced by this 
correction will be lost. Therefore, if an 
error is caused by omission of a statement, 
it is necessary to correct it from i^he card 
reader. 



fter 

if 
sion 
mode 
ion, 
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Commands may be entered at the printer- 
keyboard without interfering with a job 
stream entered from the card reader. This 
feature enables a particular user to LOGON 
at the printer-keyboard, enter commands, 
and LOGOFF, without affecting the user 
logged on at the card reader. The follow- 
ing special rules govern the handling of 
this feature: 



• If a user logs on at the card reader 
and a LOGON is submitted at the 
printer-keyboard, the LOGON submitted 
at the printer-keyboard is effective 
only for input submitted at the 
printer-keyboard, i.e., input submitted 
up to an end-of-file (space EOB) . It 
will not affect the card reader input 
stream. The LOGON submitted at the 
card reader is retransmitted, and dis- 
played if the option is selected, fol- 
lowing the input entered at the 
printer-keyboard or after a LOGOFF is 
submitted from the printer-keyboard. 

• A user may LOGON at the printer- 
keyboard and transmit a job stream only 
if there is no user logged on at the 
card reader. 

• A user may LOGOFF at the printer- 
keyboard only if he logged on at the 
printer-keyboard . 

• An invalid LOGON statement results in 
an error message sent from the central 
system (see Messages Sent to the Work 
Stations) and an RJE work station mes- 
sage, 6005. If the command was sub- 
mitted from the card reader, a 
corrected statement must be submitted 
from the card reader. 

The operator can request that all JECL 
statements entered through the card reader 
be displayed prior to transmission. They 
are displayed on either the printer- 
keyboard or the line printer. The facility 
and device are selected with the User Pro- 
gram Switch Indicators (UPSI) . Specifica- 
tion of this and other facilities requested 
in this manner is described later (see UPSI 
Specification) . 



SEQUENCE CHECKING 

All JECL statements are sequence checked 
and displayed (according to the display 
option chosen at program loading time) 
prior to their transmission. This sequence 
check ensures the proper relationship of 
RJSTART, LOGON, and LOGOFF commands to the 
other input. In a valid sequence of input 
from the card reader: 



1 . The RJSTART command must be the first 
statement submitted in the input 
stream at work station startup. 

2. The LOGON command, CONTINUE command, 
RJEND command, or null statement may 
follow an RJSTART command in the input 
stream. 

3. The LOGON command follows the RJSTART 
command if the user desires access to 
the central system. Any valid combi- 
nation of work station commands and 
job entries may follow the LOGON 
command . 

Incorrect sequence results in a require- 
ment to corr jet or bypass the statement in 
error. The operations specified in each 
JECL statement also are checked for validi- 
ty. An invalid operation at this point 
also results in a requirement to correct or 
bypass the statement. With the exception 
of the termid parameter of the RJSTART 
statement, the operands of the JECL cards 
are not checked. Errors encountered in the 
input stream are displayed to the operator 
if the display option is selected. 



OUTPUT TO THE WORK STATION 

Output directed to the work station is 
either job output or messages. Job output 
is directed to the printer, the punch, or a 
user-written output routine. Each job out- 
put data set received is directed to the 
device associated with the SYSOUT class 
specified in its DD statement. SYSOUT 
classes are assigned to devices when the 
central system is assembled. Output data 
sets not specified as one of the classes 
assigned for printed, punched, or user-exit 
output are printed at the work station. 
Data sets not defined as SYSOUT are written 
at the central installation. 

Carriage control for printer output may 
be specified by a control character as the 
first byte of each record. Either machine 
code or ASA control characters are allowed. 
If no control characters are specified for 
the data set, the output is single spaced 
with a skip to channel 1 when channel 12 is 
sensed in the carriage control tape. 
Stacker select for punched output may also 
be specified with a control character as 
the first byte of each record. Either 
machine code or ASA control characters are 
acceptable. If no control characters are 
specified, stacker 1 is selected. 

If the output is to be written by a 
device other than the printer or the punch, 
a user exit is provided. Output data sets 
are passed to the user-written output rou- 
tine for processing if they are identified 
by the SYSOUT class assigned for user 
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exits. Physical records of up to 400 bytes 
are passed to the user-written routine. 
Messages are directed to either the 1052 
printer-keyboard or the line printer. The 
message device is selected with the UPSI 
card. 

Note : If punched output is to be sent to a 
1442 card read punch, all punched output 
should be specified as deferred to prevent 
any possibility of punching into input 
cards . 



OPERATING PROCEDURES 

WORK STATION STARTUP 

To start RJE operation, the operator 
loads the RJE Work Station Program. The 
operator should follow the program- loading 
procedures for his system. The first data 
card must be the RJSTART command. For 
detailed program- loading procedures see IBM 
System/360 Basic Operating System; Control 
Programs and Assembler Operating Guide , 
Form C24-3450, or IBM System/360 Basic Pro- 
gramming Support: Basic Tape System 
Operating Guide , Form C24-3391. The 
RJSTART command may be followed either by 
input to be sent to the central system or 
by an end-of-file indicator. If the work 
station is connected to the central system 
over a switched line with manual dial, a 
message is displayed when the operator is 
to call the central system. If the work 
station has the Auto Call special feature 
installed, this phone number is coded as a 
parameter on the RJSTART command. When 
contact is made with the central system, 
the RJSTART command is transmitted. With 
the acknowledgment of this command, the 
operator receives all pending messages and 
immediate job output directed to users at 
the work station. A user may gain access 
to the central system by submitting a LOGON 
command, or may monitor for output from the 
central system. The only statements which 
may follow the RJSTART command are: 

1 . The LOGON command to allow user access 

2. The CONTINUE command to specify dispo- 
sition of discontinued output 

3. The RJEND command to terminate RJE 
activity of the work station 

4. The null Statement to indicate a tem- 
porary end-of-card input. 



1 . The device on which JECL and corrected 
statements are to be displayed 

2. The device on which message output is 
to be displayed. 

The desired options are specified by the 
bit settings: 

1. If bit is set on (1) , JECL a^id 

corrected statements are displayed on 
the line printer. 



2. If bit 1 is set on (1) , JECL apd. 
corrected statements are displayed on 
the printer-keyboard. 

3. If bit 2 is set on (1) , messages are 
displayed on the printer-keyboard. If 
bit 2 is not set on (0) messag 
appear on the line printer. 

Note : If neither bit nor bit 1 ijs set 
on, there is no display of JECL and 
corrected statements. If both bit 3 and 
bit 1 are set on, JECL and corrected state- 
ments are displayed on the line printer, 

The UPSI card for the work station pro- 
gram is coded in the following mar 

// UPSI nnn 



where nnn are the bits 0-2 required 
operation of the work station 
a complete explanation of the UPSI 
refer to BOS or BPS Programmer ' s 



program 



for the 
For 
card, 
e. 
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THE NULL STATEMENT 



be 



The null statement is provided 
System/360 work station to indicate 
file on the card reader. It must 
last card of an input stream. When 
statement is read, the card reader 
fectively closed, but communication 
still maintained with the central 



red 



Operator intervention is requi 
resume input from the card reader a 
null statement has been read (see 
Keyboard Procedures) . 



for 



the 
end-of- 

the 
this 
is ef- 
s are 
system. 



to 
fter the 
Printer- 



The null statement is coded with the 
identifying characters (..) in columns 1 
and 2 and all remaining columns blank. 
This statement has no effect on a user's 
session. If a user is logged on when a 
null statement is read, he remains (Logged 
on. 



UPSI SPECIFICATION 

The user indicates the operating options 
that he desires by setting bits 0-2 in the 
UPSI card. These options include: 



PRINTER-KEYBOARD PROCEDURES 

There are four control functions 
initiated by the operator from the printer- 
keyboard: discontinuing output, signifying 
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card reader input, signifying printer- 
keyboard input, and signifying end-of-file 
on the card reader after an error. These 
functions are initiated by the operator 
pressing the request key on the printer- 
keyboard and replying with a nonnuineric 
reply to the request message (07 02 A) . When 
the message 6999A appears, the operator 
enters the appropriate reply to initiate 
the function he desires (see RJE Messages, 
for replies to the 6999A message) . 

If the operator has indicated printer- 
keyboard input, after receiving the 6999 
message, he enters the desired commands 
with an EOB at the end of each command. 
After entering the last command, a blank 
and an EOB must be entered to signify end 
of input . 



DISCONTINUING OUTPUT 

Output can be discontinued by operator 
intervention. An intervention request is 
made by pressing the request key on the 
1052 printer-keyboard and entering a non- 
numeric reply to the request message 
(0702A) . When the operator intervention 
message (6999A) is displayed, the operator 
responds by entering a D to discontinue 
output. Once output is discontinued, no 
other output is transmitted to the work 
station until the disposition of the dis- 
continued output is specified by the CON- 
TINUE command. 



allowable interval, the central system log- 
ically detaches the work station from the 
RJE system. In addition, if the work sta- 
tion is connected over a switched line, the 
central system breaks the connection. 

In the case of a local I/O device error, 
with the exception of the card reader, 
normal BOS/BPS messages inform the operator 
of the need for intervention. The opera- 
tor * s reply to the message indicates how 
the error is to be corrected. 

If an error occurs on the card reader, a 
message (6012) is issued to inform the 
operator that intervention is required. 
Communications are maintained with the 
central system. To resume card reader 
input, the operator communications proce- 
dures should be follwed (see Printer- 
Keyboard Procedures) . If the problem can- 
not be corrected, operator communication 
procedures should be initiated to close the 
card reader (see Printer-Keyboard 
Procedures) . 

Irrecoverable communication errors 
result when communication is lost with the 
central system because of either line 
errors or a central failure. In either 
case, the work station is logically 
detached by the central system and restart 
procedures are necessary. The response 
received when restart procedures are 
executed indicates whether the error was 
due to a line error or to a central 
failure. 



CONTINUING OUTPUT 

Disposition of discontinued output is 
specified with the CONTINUE command (see 
CONTINUE) . Output is discontinued if: 

1 . The remote operator requests 
di scontinuation . 

2. A change in form number is found at 
the central system. 

3. An irrecoverable error occurs during 
an output operation. 



To terminate RJE operation because of an 
error, the operator must reply with an 8 to 
any message except those issued by the work 
station program (those starting with a 6) . 
On messages issued by the work station pro- 
gram, he must reply with a 1 and manually 
disconnect the adapter. If no message is 
issued, the operator should press the requ- 
est key on the printer-keyboard and reply 8 
to the request message. 



If conditions one or two occur, the dis- 
position of the output is specified with 
the CONTINUE command. Condition three 
requires error recovery procedures. 



ERROR RECOVERY PROCEDURES 

At a System/360 work station, facilities 
are provided to recover from both communi- 
cation errors and local device errors. 
Operator intervention may be necessary to 
correct the condition causing the error. 
If the error cannot be corrected in an 



RESTART PROCEDURES 

Restart procedures involve regaining 
communication with the central system and 
submitting an RJSTART command. If the: 
error occurs during an output operation, 
output automatically resumes either where 
it was interrupted (after a line error) or 
at the beginning of the job (after a centr- 
al failure) . 

If the error occurs during an input 
operation, all unacknowledged input must be 
resubmitted. 
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RJE MESSAGES 



6000A 



6001A 



6002 or 



RJSTART Command Required 

Explanation ; An error has 
occurred that has caused loss of 
communication with the central 
system. The line has been closed, 
and an RJSTART command must be 
submitted from the card reader to 
reestablish communications. 



System Action ; 
for the reply. 



The system waits 



Operator Response ; The operator 
must enter a valid RJSTART command 
through the card reader in order 
to resume processing. The 
following reply is the only valid 
response to this message: 

A - The RJSTART command has been 
entered into the card reader. 



RJSTART Command Invalid 

Explanation : The RJSTART command 
submitted is invalid. 



System Action : 
for the reply. 



The system waits 



Operator Response : The operator 
must enter a valid RJSTART command 
in order to resume processing. 
The operator enters one of the 
following letter codes to indicate 
how he desires to correct the 
error: 

A - The error is to be corrected 

from the card reader. 
B - The error is to be corrected 

from the printer-keyboard. 

On a switched line the operator 
has approximately three minutes to 
enter a reply. 



60 02A LOGON, RJEND, or CONTINUE 
Required 

Explanation : Input submitted was 
either in error or out of 
sequence. A LOGON, RJEND, or 
CONTINUE command is required. The 
LOGON command is required if input 
is available for transmission to 
the central system. The RJEND 
terminates RJE activity at the 
work station. The CONTINUE 
command is entered if output was 
discontinued. 



System Action : The system waits 
for a reply from the 
printer-keyboard, or, if the 
message does not require a reply, 
for input from the 
printer-keyboard. 



Operator Response : If the Imessage 
requires a reply, the operator 
enters one of the following codes 
to indicate the corrective j action 
taken: 



A - 



B - 



C - 



The error is to be corrected 
from the card reader. 
The error is to be corrected 
from the printer- keybocird. 
Bypass input in card reader 
until a LOGON, RJEND, d>r 
CONTINUE command is foiind. 



requ 



enter 



ire a 
the 



If the message does not 
reply, the operator may 
correction through the 
printer-keyboard followed by an 
EOB or enter a space EOB t 
indicate that the command 
ignored. On a switched 
operator has approximately 
minutes to enter the reply. 



line 



s to be 

, the 
3 



6003A Invalid JED Continuation, ^ED-JOB 
Sequence, or No JOB Card | 



Explanation : This message 
indicates that a statement 



other 



than a continuation card fallows a 
continued JED statement, a JOB 
card does not follow a JED 
statement, or there is no JOB 
card. 



System Action : The system waits 
for a reply from the 
printer-keyboard, or, if the 
message does not require a reply, 
for input from the 
printer-keyboard. 

Operator Response : The operator 
enters one of the three codes to 
indicate the corrective action 
taken: 

A - The error is to be corrected 

from the card reader. 
B - The error is to be corrected 

from the printer-keybocird. 
C - Bypass the job associated with 

the error in the card reader 

until a JECL or JOB statement 

is found. 

On a switched line the operator 
has approximately three minutes to 
enter the reply. 
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6004 or 6004A Invalid JECL Operation 



6010 



Dial 



6005 



Explanation : This message 
indicates that a JECL statement 
with an undefined operation has 
been submitted. If the operator 
can recognize the intended 
operation, he should correct it; 
if he cannot, he should have the 
statement bypassed. 

System Action : The system waits 
for a reply from the 
printer-keyboard, or, if no reply 
is required, for input from the 
printer- keyboard. 

Operator Response : If the message 
requires a reply, the operator 
enters one of three codes to 
indicate the corrective action 
taken: 

A - The error is to be corrected 
from the card reader. 

B - The error is to be corrected 
from the printer-keyboard. 

C - Bypass input in the card 

reader until the next JECL or 
JOB statement is found. 

If the message does not require a 
reply, the operator may enter the 
correction through the 
printer-keyboard followed by an 
EOB or enter a space EOB to 
indicate that the command is to be 
ignored. On a switched line the 
operator has approximately three 
minutes to enter the reply. 



Central System has Aborted Input 

Explanation : The central system 
has aborted input from the work 
station and has sent a message 
explaining why the input was 
aborted. (For details on messages 
received, see Messages Sent to 
Work Stations.) 

System Action : The system waits 
for input from the line, or for 
the operator to initiate input 
from the card reader or 
printer-keyboard . 

Operator Response : The operator 
inspects the message and takes the 
indicated action. To resume input 
the operator must follow the 
procedures under Printer- Keyboard 
Procedures. 



6011A 



6012 



6999A 



Explanation : This message is 
issued on manually dialed lines at 
the time the operator may start 
dialing the number. 

System Action : When the number 
has been dialed, the system opens 
the line. 



Operator Response : 
dials the number. 

Open Failure 



The operator 



Explanation : The attempt to open 
the line has failed. 



System Action : 
for the reply. 



The system waits 



Operator Response : The operator 
enters one of the following codes 
to indicate the action desired: 

5 - Retry the OPEN. 

or 1 - Cancel the program. 

Intervention Required on Card 
Reader 

Explanation : An error has 
occurred on the card reader which 
required operator intervention. 

System Action : The system waits 
for operator communications to be 
initiated. 

Operator Response : The opercitor 
corrects the problem on the card 
reader, if possible, and initiates 
operator communications procedures 
to resume card reader input [see 
Printer-Keyboard Procedures) . If 
it is not possible to correct the 
problem, operator communication 
procedures must be initiated to 
signify end-of-file (..null card) 
on the card reader (see 
Printer- Keyboard Procedures) . 

On a switched line, these actions 
must be accomplished within 
approximately three (3) minutes in 
order to maintain communications 
with the central system. 



Operator Intervention Request 
Recognized 

Explanation : This message is 
displayed when a request for 
operator intervention can be 
serviced. 
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System Action : 
for a reply. 



The system waits 



Operator Response ; The operator 
enters one of the following codes 
to indicate the type of 
intervention desired: 

A - Input is available at the card 
reader. 

B - Commands are to be submitted 
from the printer- key board. 

D - Discontinue receiving output 
(this includes job output and 
messages) . 

E - Generate end-of-file on the 

card reader. This response is 
accepted only when 
intervention on the card 
reader (6012) has been issued. 

N - Ignore the request. 

Note : After a 6012 message has 
been issued, A and E are the only 
valid replies to this message. 
When the E reply is used, and the 
reader error occurred in the 



middle of an OS job, the jbb 
should be deleted by submitting a 
DELETE command at the 
printer-keyboard. This willl avoid 
execution of a partial jobL 



6999 Proceed j 

Explanation : This message is 
displayed as a result of a B reply 
to the 6999A message. The work 
station is ready to receive 
commands from the j 
printer-keyboard. 

System Action : The system) waits 
for input from the ; 
printer- keyboard. 

Operator Response : The operator 
enters the desired commands by 
pressing the EOB button after each 
command. After entering the last 
command, he enters a space and an 
EOB to indicate that he has 
finished using the 
printer-keyboard. On a switched 
line the operator has 
approximately three minutes to 
enter each command. 
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GENERATING THE RJE WORK STATION PROGRAM 

THE RJE ASSEMBLY MACRO INSTRUCTION 

The Remote Job Entry Work Station Pro- 
gram for a System/360 is constructed by an 
assembly and link edit of the RJE macro 
instruction. The assembly of the RJE macro 
results in an object module. This object 
module is then link edited with the user- 
written output routine if the user exit is 
used. The link-edit step creates the 
executable load module which is loaded into 
main storage for execution as with any 
other problem program. Figures 12 and 13 
illustrate this process. 

Programmer's Note ; In assembly of the RJE 
macro, the user must supply an END card 
with the transfer address of IHKDBSRT as in 
the following example: 

END IHKDBSRT 

If a user-exit routine is to be included, 

the END card of the source deck of the 

user- exit routine must not have a transfer 
address in the operand field. 



r t 

| Operation | Operand 

,. h 

RJE I TERMID=termid 



, UEXIT=YES 
, UEXIT=NO 

",PRT=120" 
, PRT=132 
.,PRT=144 

~,RDR=01" 
,RDR=2 
, RDR=4 
,RDR=42 



-XJr. 



, INTRFC=A 
,INTRFC=B 



, DISK=YES 
,DISK=NO 



,PCH=20 
, PCH=40 
,PCH=42 



', DIAL=NO " 
, DIAL=MAN 
, DIAL=AUTO 



, CODE=A 
, CODE=B 



TERMID=termid 

specifies the RJE name of the work 
station. This name must be the same 
name that was specified for the work 
station when the central system was 
created. It is used as a standard 
when this parameter is checked in the 
RJSTART command. It is the only pa- 
rameter required if the remaining pa- 
rameters are correct as assumed. 

UEXIT=YES 

UEXIT= NO 

UEXIT=YES indicates that a user- 
written output routine is to be 



included in the RJE work station 
gram. A System/360 having morf 
16K bytes of main storage is r 
if a user-written output routiike is 
included. If the UEXIT=NO keyword 
coded or the parameter is omitted, 
exit is not provided. 



pro- 
than 
quired 



xs 
the 



DISK=YES 

DISK=NO 

indicates whether the configuration of 
the work station is disk-resident 
(BOS) or not disk-resident (BPS) or 
BOS card supervisor. If the parameter 
is omitted, a disk- resident system is 
assumed. j 

I 

PRT=120 

PRT=132 

PRT=144 

specifies the maximum number of print 
positions available on the line: print- 
er. If this parameter is omitted, a 
print line of 132 characters is 
assumed. 



20 

40 

PCH=42 



PCH 
PCH 



indicates the type of punch available 
at the work station: ! 



20 
40 
42 



specifies an IBM 2520 Card 
Punch or Card Punch. 



Read 



specifies an IBM 2540 Card (Read 
Punch. 



specifies an IBM 1442 Card 
Punch. 



If the parameter is omitted, a 
Card Read Punch is assumed. 



Read 



2540 



=01 
=20 
=40 
RDR=42 



RDR= 
RDR= 
RDR= 



indicates the type of card reaqer 
available at the work station: I 



01 specifies an IBM 2501 Card 

20 specifies an IBM 2520 Card 
Punch. 

40 specifies an IBM 2540 Card 
Punch. 



Reader, 
Read 

Read 



42 specifies an IBM 1442 Card [Read 
Punch. 

If this parameter is omitted, a 1 2540 
Card Read Punch is assumed. ! 
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BOS SYSTEM GENERATION 



OPTIONAL < 








/ 






/ 


/ 


1 


( USER-EXIT OBJECT 
DECK (OPTIONAL) 




/ 


/ 


/ 




'WORK STATION 
PROGRAM OBJECT 
DECK 

1 _ 1 


/ 



RELOCATABLE OBJECT 
MODULES ON CARDS 
OR RELOCATABLE 
LIBRARY OF SYSRES 



SYSRES 




Figure 12. BOS System Generation 
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MODULE 
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IMAGE 

LIBRARY 

SYSRES 



84 



BPS SYSTEM GENERATION 






r 


END 








/ 


/ 










/ 






SOURCE DECK 








> OPTIONAL 


/assembler 

f CONTROL CARDS 










/end IHKDBSRT 










/rJE MACRO 
( STATEMENT 






— — 1 .• 


/assembler 
control cards 







S/360 
ASSEMBLE 



USER-EXIT OBJECT 
DECK (OPTIONAL) 



WORK STATION 
PROGRAM OBJECT 
DECK 




SYSTEM 
TAPE 



V 



S/360 
LINK EDIT 



LOADABLE 
OBJECT MODULE 



Figure 13. BPS System Generation 
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DIAL=N O 

DIAL=MAN 

DIAL=AUTO 

specifies the type of communication 
line used by the work station: 



WO specifies point-to-point conten- 
tion communication over a non- 
switched line. 



MAN specifies point-to-point conten- 
tion over a switched line with 
manual dialing. 



AUTO specifies point-to-point 
contention 
over a switched line with the Auto Call 
special feature installed on the 2701. 



< - 

Or 



— Fu 1 lwor d > 
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| Record Type | 



Record Address 
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Physical Record Length 



Logical Record Length 
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I I 

| Control | 
J Character | 

L J 

Record Type : A one- byte code in hexadecim- 
al representation indicating the type of 
record: 



If this parameter is omitted, DIAL=NO 
is assumed. 

INTRFC=A 

INTRFC=B 

specifies which interface provided by 
the 2701 is to be used when the Dual 
Interface feature is installed. If 
the parameter is omitted, INTRFC=A is 
assumed. 

C0DE=A 

CODE=B 

specifies which code is EBCDIC when 
the dual-code feature is installed on 
the 2701. If this parameter is 
omitted, CODE=A is assumed. 



F1 - Fixed blocked records 
F2 - Fixed unblocked records 
F3 - Variable blocked records 
F4 - Variable unblocked records 
F5 - Undefined records 
00 - End of File 
FF - End of Job 

Record Address : The address of the physic- 
al record passed to the routine. 

Physical Record Length : The length (a 
binary value) of the physical record passed 
via the user exit. 

Logical Record Length : The length (a 
binary value) of the logical records when 
fixed length records are passed via the 
user exit. 



USER- EXIT INTERFACE 

Physical records are passed to a user- 
written output routine via an exit. This 
output routine need not save registers upon 
entry. The user must set up addressibility 
for his routine and save any information he 
requires for subsequent entries. The entry 
point of the routine must be named IHKUSR. 
This routine receives control whenever out- 
put is available for it. The following 
information is passed to the user's 
routine: 

Register 1 contains the address of a para- 
meter list. 

Register 14 contains the return address. 

Register 1 contains the address of the 
parameter list which describes the output 
passed to the routine. This parameter is 
aligned on a fullword boundary. The format 
of this parameter list is: 



Control Character : A one- byte code (hexi- 
decimal representation) indicating the type 
of control characters. 

F1 - Machine code control characters 
F2 - ASA control characters 
F3 - No control characters 

Note : The logical record field should be 
ignored with variable and undefined record 
types. 



SUPERVISOR ASSEMBLY CONSIDERATIONS 

Operation of the RJE support at a remote 
System/360 work station depends upon the 
following parameters specified in the macro 
instructions for generating a supervisor: 

1. SUPVR Macro Instruction 
CR=YES 

indicates that operator-initiated 
communication is used with the 
1052 printer-keyboard. 
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2. IOCFG Macro Instruction 
DVEr=n 

n must be specified as at least 2 
for RJE operation. 

BSC=YES 

must be specified to include 
binary synchronous communication 
interrupt handling and error 
recovery routines in the 
assembled supervisor. 

BTAB=n 

n must be at least 1 for RJE 
operation. 



3. SYMUN Macro Instruction 

Since the device assignments are fixed 
for RJE operation, symbolic units may 
be assigned at system generation so 
that no ASSGN cards will be required 
when the Job Control cards are sub- 
mitted for RJE operation. The follow- 
ing assignments are used: 



SYS002 



must be assigned to the card 
punch used for RJE punch4d 
output. 



SYS003 



must be assigned to the line 
printer used for RJE printed 
output . 



SYS004 



SYS001 



must be assigned to the card 
reader used for RJE input. 



must be assigned to the Sf701 Syn- 
chronous Data Adapter used for 
RJE communication. 



SYSLOG 

must be assigned to the 1052 
printer- key boa rd . 

For a complete explanation of [proce- 
dures involved in generating 4 super- 
visor , refer to IBM System/3 60| Basic 
Operating System; System Generation 
and Maintenance , Form C24-506CJ; IBM~ 
System/360 Basic Programming Support: 
Programmer's Guide , Form 024-335*1; and 
IBM System/360 Basic Programming Sup- 
port: System Generation and Main- 
tenance . Form C2U-5061. 
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2780 DATA TRANSMISSION TERMINAL 



The IBM 2780 Data Transmission Terminal 
(Model 1 or 2) is a supported work station 
in the RJE system. It provides input and 
output capability over common carrier com- 
munication lines via binary synchronous 
communications procedures. Model 1 sup- 
ports card input and printer output. Model 
2 supports card input, printed output, and 
punched output. The special features 
required for either model of the 2780 used 
for RJE processing are the following: 

1. EBCDIC Transmission Code 

2. EBCDIC Transparency 

3. Print Line (either 120-character or 
1 44-character) 

4. Automatic Turnaround (Model 2 only) 

5. Extended (Enquiry-ENQ) Retry 
Transmission 

In addition, the following special fea- 
tures are supported, but not required: 

1. Multipoint Line Control 

2. Multiple Record Transmission 

For a description of the various 
switches, lights, and controls, the user is 
referred to IBM 2780 Data Transmission Ter- 
minal — Component Description , Form 
A27-3005. 



OPERATING PROCEDURES 

Normal Operation 

Sending Input 

After powering up the 2780 according to 
procedures in the 2780 manual, an RJSTART 
card is placed in the card reader. If no 
further input is to be sent and punched 
output is expected, blank cards are placed 
behind the RJSTART card to trigger the Auto 
Turnaround feature. If no punched output 
is expected, no cards follow the RJSTART. 
If additional input is to be sent, a LOGON 
card and the additional input follow the 
RJSTART. 

When the input has been placed in the 
reader, the mode switch is placed in the 
"transmit transparent" position, and if 
there are no blank cards following the 
input data (no punched output is expected) , 
the EOF button must be pressed. If punched 
output is expected, the Auto Turnaround 
feature must be activated by pressing the 
Auto Turnaround button (the button will 



light when active) . If the connection is 
via a switched line, the number must be 
dialed at this time. After the line con- 
nection is made, the start key must be 
pressed to transmit the data. 

The 2780 sends all the cards in the 
reader before performing line turnaround to" 
look for output from the central system. 
The audible alarm will be triggered either 
by reading a blank card (by the Auto Turna- 
round feature on the Model 2) or by recLding 
the last card if the EOF key has been 
pressed. This alarm will sound until it is 
turned off either by receiving output from 
the central system or by operator interven- 
tion. If line turnaround is triggered by 
running out of cards (implies no Auto Turn- 
around) , only the printer will be ready to 
receive output. 

Receiving Output 

When the 2780 receives an EOT after 
receiving a complete transmission, the au- 
dible alarm sounds unless the reader is in 
ready status. The alarm is turned off when 
the 2780 receives an ENQ from the central 
system signifying more output, or when the 
operator presses the stop key causing the 
2780 to drop ready status. The start keys 
for the printer and reader/punch must be 
pressed to return the 2780 to ready steitus. 

Discontinuing Output 

Output in progress may be discontinued 
at any time by pressing the stop key (on 
the reader/punch) . After output has been 
discontinued, the central system will 
accept input but no output will be sent 
until a CONTINUE command is received. The 
CONTINUE command allows three options so 
that discontinued output may be either: 

1. restarted from the beginning of the 
data set, 

2. continued with the SYSOUT block con- 
taining the last block transmitted, or 

3. deleted by the options specified in 
the CONTINUE command. 

Special Forms Output 

Output requiring special forms or ccirds 
is automatically discontinued by the cen- 
tral system before it is transmitted, and a 
message giving the required form or card 
number is sent from the central system to 
the 2780. 
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Printer 

For printed output, the required forms 
must be placed in the printer and a CON- 
TINUE command must be transmitted from the 
2780 reader. Upon receipt of this command 
the central system transmits the output. 

Punch 

For punched output, the required blank 
cards must be placed in the hopper (if Auto 
Turnaround is triggered) . If Auto Turna- 
round is not active, a CONTINUE statement 
should be submitted to trigger the Auto 
Turnaround feature. After the CONTINUE 
command is received, the central system 
transmits the output to the punch. If the 
punch is not ready, output is discontinued, 
and a CONTINUE is issued to continue trans- 
mitting. There can be no punched output if 
the Auto Turnaround feature is not active. 

Preparing More Input 

While output is being written on the 
printer, the operator may load and ready 
the reader to send more input (unless Auto 
Turnaround is active) . Since the work sta- 
tion is already in the active or processing 
state (see States of Work Stations) , no 
RJSTART command is submitted. Unless the 
work station is inactive state, or unless 
the work station is in the processing state 
and a new user desires access to the sys- 
tem, no LOGON command is required. When 
the output to the printer is finished, the 
2780 may send input. If the output is 
being received at the punch (or the print- 
er, if Auto Turnaround is active) , the 
operator must wait until the output has 
been completed. Then, after removing the 
punched output (if any) and blank cards, 
the operator may reload and prepare the 
reader to transmit input. On a switched 
line the reader must be readied within 
approximately three minutes to prevent the 
central system from disconnecting the line. 

Error Recovery Procedures 

In general the detection of any per- 
manent line I/O error at the central system 
will cause the terminal to be disconnected. 
When this happens, the line connection must 
be reestablished (for a switched line) and 
the RJSTART and LOGON commands must be 
resubmitted along with the last unacknowl- 
edged input. A line error message will be 
returned along with the RJSTART accepted 
message. Other errors and their associated 
recovery procedures are described below. 

Failure During Input 

When the 2780 card reader fails (jams, 
etc.) , the condition should be corrected 
and the card reader and printer brought to 



ready status. Recovery must be madje within 
approximately 3 minutes for input tb be 
resumed according to the error recovery 
procedures defined in the 2780 manujal. If 
the time required to ready the readjer 
exceeds 3 minutes on a switched linje, an 
RJSTART and a LOGON command are required to 
resume input operations, and all unacknowl- 
edged input must be resubmitted (assuming 
one job submitted at a time) . Whenj more 
than one job^is being processed, onjly the 
jobs from the point of failure and the 
entire job in which the failure occurred 
must be resubmitted. If the Auto Answer 
feature is present and active on a (switched 
line, the line will be disconnected! within 
21 seconds, not 3 minutes, if recovery is 
not made within that time. 



Aborted Transmission 



The central system will abort data 
transmission if an RJSTART or LOGON command 
is missing. The 2780 will drop reaiy sta- 
tus; the INCP light will be turned bn, and 
the audible alarm will sound. No message 
will be returned to indicate the e rror . 

nust 



The omitted command and all input mi 
resubmitted . 



be 



Input Stream Flushed 

When an error causes the central system 
to flush the entire input stream being 
transmitted from the work station, one of 
the following messages will be returned to 
the 2780: 



IHK114I 
IHK140I 
IHK141I 
IHK1U2I 
IHK143I 
IHK144I 
IHK145I 

IHK147I 

IHK148I 

IHK150I 

IHK161I 



MAX JOBS EXCEED jobname \ 
INVALID USERID LOGON 
INVALID PROTECTION KEY LOGON 
INVALID TERMID RJSTART 
INVALID JOBNAME JOB 
DUPLICATE JOBNAME jobname 
NO JOB CARD 

f RJSTART } 

reqd parameter missing \l0&0n j 
|rjstart| 

ILLEGAL DELIMITER JlOGON j 

(rjstart) 
undefined keyword \ logon j 

f SYSIN ! ) 
OUT OF SPACE | SYS 1 . SYS JOBQj I 
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IHK162I SYSIN LIMIT EXCEEDED jobname 

/ 
IHK163I DISK ERROR 






Q MGR RJE ABORTED 
Q MGR [jobname] I 
volume-serial 4 
jobname ddname I. 

The recovery procedures for each of these 
messages are described in the section Mes- 
sages Sent to Work Stations. 

Failure While Receiving Output 

Unit Failure 

When the printer or punch fails, the 
condition should be corrected. On a 
switched line, if the problem can be 
corrected and the 2780 can be brought to 
ready status within 3 minutes, a CONTINUE 
command may be transmitted, and the output 
will resume according to the option speci- 
fied in the CONTINUE command. If recovery 
requires more than 3 minutes, the connec- 
tion must be reestablished and an RJSTART 
command must be transmitted. The inter- 
rupted data set can then be transmitted 
from the point of interruption. On a non- 
switched line there is no time limit, and 
the output may be requested via a CONTINUE 
command. 

Note : If punched output is to be received, 
blank cards must follow the CONTINUE com- 
mand to trigger the Auto Turnaround 
feature. 

Unit Not Ready 

If the central system tries to transmit 
to a device that is not in ready status, 
the audible alarm sounds, and the TERM 
ADDRESSED light comes on. Follow the pro- 
cedures outlined under Unit Failure for 
recovery procedures. 

Central Failure 

If the central system fails while output 
is in progress, the terminal is placed in 
an inactive status. When the central sys- 
tem comes back on line, submit an RJSTART 
command. The message ABNORMAL CENTRAL CLO- 
SEDOWN is returned with the RJSTART 
acknowledgment message. After these mes- 
sages, output that was in progress at the 
time of the failure is resumed from the 
beginning; it may or may not be the first 
output to be received after communications 
are reestablished. 

Testing the RJE System 

If it is desirable to test the system to 
check that transmissions are being 
received, a message may be sent to the 
sending work station. If it is returned 
the system is in working order (i.e., the 



user may send himself a message, and if he 
receives it on the printer, the system is 
working properly) . 

Recommended Operating Suggestions 

To minimize the recovery effort in case 
of an error, the following procedures are 
recommended to the 2780 operator: 

1 . The RJSTART and LOGON commands may be 
submitted separately to insure that 
they are correct. 

2. Job input streams should be limited to 
a few jobs in order to limit the num- 
ber that must be resubmitted in case 
of an input error which requires the 
central system to flush the entire 
input stream. 

3. Remote Job Entry operations on the 
2780 are in "transmit transparency" 
mode at all times. 

4. If punched output is expected, it is 
recommended that the Auto Turnaround 
feature be triggered by blank cards 
and then that the user wait for the 
output. The end of output is sig- 
nalled by the audible alarm, and at 
this time more input may be submitted 
if desired. If it is urgent that more 
input be submitted, discontinue out- 
put. Then the desired input can be 
submitted. The Auto Turnaround fea- 
ture must be used to get punched 
output. 

5. Unless it is certain that no punched 
output is going to be sent, the fol- 
lowing steps should be performed 
before submitting input: 

a. Press the STOP button. 

b. Press the NPRO button (to flush 
cards) . 

c. Set mode switch to OFFLINE and 
back to TSM TRSP (to drop ready 
status on the printer and the 
punch) . 

d. Ready the printer. 

e. Place the input cards and blank 
cards in the hopper. 

f. Press the Auto Turnaround and the 
START buttons, respectively. 

6. If it is certain that no punched out- 
put is expected (always for a Model 

1) , follow steps a through d, above, 
and then place the input cards in the 
hopper, and press the End-of -Files and 
START buttons, respectively. 

7. For expected punched output, when Auto 
Turnaround has not been used, place 
blank cards in the hopper, and press 
the Auto Turnaround and START buttons 
to ready the punch for the output: that 
is to be received. 
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IBM 1130 COMPUTING SYSTEM 



1, 1968 



The IBM 1130 Computing System with the 
IBM-supplied RJE program is a supported 
work station. The 1130 RJE program 
operates under the supervision of the 1130 
Disk Monitor System Version 2,, and observes 
the required RJE communication conventions- 
Input submitted at the work station is 
transmitted to the central system. Output 
directed to the work station is routed to a 
specified output device or to a user- 
written routine. The operator has the 
ability to interrupt receipt of output. 

MACHINE AND DEVICE REQUIREMENTS 



The RJE program f 
requires an 1131 CPU 
printer-keyboard,, wi 
storage drive and at 
storage. The mininu 
sists of a card read 
line printer with a 
line. The 1130 Syst 
a 1200-2400 bit-per- 
chronous Communi cati 
mode. 



or an 1130 work station 
„ including a console 
th a single disk 

least 8K words of main 
m configuration con- 
er, a card punch, and a 
120-character print 
eir must be connected to 
second line via a Syn- 
ons Adapter in binary 



A user- written routine may specify out- 
put on any available output device. An 
1130 system with 16K words of main storage 
is required to support a user- written rou- 
tine. Data directed to the user-exit is 
stored on disk and can be processed by 
another user program after RJE is 
terminated. 

COMMUNICATION CONSIDERATIONS 

The 1130 RJE Work Station Program pro- 
vides the standard RJE communications 
interface to the RJE communications network 
using SCAT2 and SCAT 3 binary synchronous 
communications subroutines to provide the 
following capabilities: 

1. Point-to-point contention operation on 
leased lines 

2. Point-to-point operation on switched 
networks 

3. Multipoint operation with the 1130 
System as a slave station. 

All data transmissions between the cen- 
tral processor and a remote 1130 are in 
EBCDIC transparent mode except headings, 
which are transmitted in normal (non- 
transparent) mode. Communication with the 
central processor proceeds in three modes: 
monitor, receive, and transmit. 



Monitor mode is entered from either 
transmit or receive mode. In monitor mode, 
the work station waits for input frcbm the 
line, card reader, or console- keyboard. 



Receive mode is ent 
available for the work 
mode, the terminal rea 
line until it receives 
cation from the centra 
operator discontinues 
end- of -data indication 
operator intervenes to 
put, the work station 



ered when output is 

station. Inl receive 
ds output from the 

an end-of-dara indi- 
1 system or ujvtil the 
the output, ttfhen an 
is received 6r the 
discontinue the out- 
enters monitor mode. 



Transmit mode is entered at work 



the 



startup, and when input is availably 
work station. In transmit mode 
station writes to the line. It 
writing to the line until it has en^oun 
tered a logical end-of-file (null 
or RJEND command) in the input strekm 



continues 



statement 



indicat 



If monitor irode is entered from 
mode with a logical end-of-file 
transmit mode is not entered again 
operator intervention indicates that 
input is available. 



station 
at the 
work 



■transmit 
ion, 
until 
more 



COMMUNICATION CONSIDERATIONS FOR SWITCHED 
LINES 

If a switched communication line is 
inactive for a period of approximately 21 
seconds, the central RJE program discon- 
nects the line. This can be caused by 
three situations: 

1. The remote RJE program cannot Maintain 
the connection when an error oh an 
output device is not corrected within 
the specified time. 

2. The remote RJE program cannot jmaintain 
the connection when a user-written 
routine fails to return controfL within 
the specified time. 



The remote PJE program is wait 



ing for 



an operator response. When requested 
to reply to some RJE messages, the 
operator irust enter his response 
within the specified time. In some 
cases, the operator has approximately 
three minutes to reply (see 'Operator 
Messages 1 section for detailed 
information) . 
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INPUT AT THE WORK STATION 

Input is accepted from the card reader,, 
the console-keyboard,, and from one or more 
disk storage units,. 

Job entries and work station commands 
are acceptable input from the card reader,. 
No JECL statements are sequence checked. 
The first statement at work station startup 
must be an RJ START command submitted from 
the card reader. 

The only valid input from the console- 
keyboard is work station commands. Input 
is accepted from the console-keyboard 
between jobs (only in a point-to-point line 
configuration) from the card reader when 
the operator has indicated that he has such 
input to submit. The 1130 Work Station 
Program checks this input for the JECL 
identifier (,. . followed by at least one 
blank) only. 



Input is also ace 
disk storage units, 
control card (.. DAT 
trol this function, 
be placed in the car 
disk. It contains i 
RJE program to read 
the card reader and 
be read from disk mu 
prior to RJE process 
stored in 80-charact 
packed code format ( 
tor) , in consecutive 
ing this input to en 
gram resumes reading 

Note ; If a user is 
reader or disk and a 
submitted from the c 
pending input at the 
from disk will be su 
LOGON userid. To pr 
LOGON command, which 
card reader, must be 
command from the ccn 



epted from one or more 

A special 1130 RJE 
A) is defined to con- 

This control card may 
d input stream or on 
nformation allowing the 
input alternately from 
from the disk. Data to 
st be stored there 
ing. This data must be 
er records in 8-bit 
eight records per sec- 
sectors. After read- 
d of file, the RJE pro- 
from the card reader. 

logged on at the card 
nother LOGON command is 
onsole-key hoard, all 

card reader and/or 
biritted under the new 
event this, the last 
was submitted from the 
submitted as the last 
scle-key board. 



OUTPUT TO THE WORK STATION 



Output to the wor 
job output and messa 
sisting of SYSOUT da 
job,, is directed to 
or a user-exit routi 
data set is directed 
ciated with the SYSO 
the DD statement for 
RJE system messages 
conscle-printer or t 



k station consists of 
ges. Job output, con- 
ta sets created by the 
the printer, the punch, 
ne. Each job output 

to the device asso- 
UT class specified in 

the output data set. 
are directed to the 
he line printer. 



If characters not recognized by the equip- 
ment or no control characters are speci- 
fied, the output is single-spaced with a 
skip to channel 1 when channel 12 is sensed 
in the carriage control tape. 

Stacker Select, for punched output,, if 
available may be specified by a control 
character as the first byte of each record. 
Either ASA or machine code control charac- 
ters are accepted. If characters not rec- 
ognized by the hardware or no characters 
are specified, stacker 1 is selected. 



The 1130 RJE Remote 
includes a user-exit r 
output data sets direc 
them on disk in an are 
user. This routine ma 
another user-written r 
data directed to the u 
output to any availabl 



Work Station Program 
outine which accepts 
ted to it and writes 
a reserved by the 
y be replaced by 
Outine to process 
ser-exit and to write 
e device. 



Carriage control for printer output may 
be specified by a control character as the 
first byte of each record. Either machine 
code or ASA control characters are allowed. 



If no user- written routine is present, 
the RJE program writes user- exit data sets 
consecutively on disk, each data set begin- 
ning at a sector boundary. However, if the 
RJE program is reloaded, data sets pre- 
viously written on disk are unprotected and 
may be destroyed since any additional user- 
exit data sets are written beginning at the 
first sector of the reserved area. 

The primary output device for messages 
is the console-printer. The secondary 
device is the line printer. The operator 
selects the line printer as the message 
device by turning on console switch 0. 

Note : Data directed to disk may be 
referenced later by a .. . DATA statement. 
To be able to do this, the user must define 
his data set as fixed blocked or unblocked 
with a logical record length of 80 bytes 
and no control characters. 



OPERATING PROCEDURES 

Work Station Startup 

To start RJE operation, the operator 
loads the 1130 RJE Work Station Program. 

The operator should follow the program- 
loading procedures for the system. The 
first data card must be the RJSTART com- 
mand. For detailed program- loading proce- 
dures see IBM 1130 Disk Monitor System, 
Version 2, Programming and Operator's 
Guide , Form C2 6-3717. 

The RJSTART command iray be followed 
either by input to be sent to the central 
system or by an end-of-file indicator 
(e.g.,, a null statement for the card read- 
er). If the work station is connected to 
the central system over a switched line, a 
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message is displayed telling when the 
operator is to call the central system. 
When contact is made with the central sys- 
tem, the RJSTART command and all other com- 
mands, if any, before the first job entry 
(the OS/360 job with or without the JED 
card) or before the end-of-file indicator, 
are transmitted. The work station is log- 
ically attached to the RJE system with the 
acknowledgement of the RJSTART command. 
The operator receives all pending messages 
and immediate job output directed to users 
at the work station. All pending input, if 
any, is transmitted or the work station 
program monitors the line for output from 
the central system. The seguence of events 
is system dependent. 

The Null Statement 

The null statement is provided for the 
1130 station to indicate end of file on the 
card reader. It must be the last card of 
an input stream. When this statement is 
read, the card reader is effectively 
closed, but communication is still main- 
tained with the central system. 

Operator intervention is reguired to 
resume input from the card reader after the 
null statement has been read. 

The null statement is coded with the 
identifying characters (..) in columns 1 
and 2 and with all remaining columns blank. 
This statement has no effect. on a user's 
session. If a user is logged on when a 
null statement is read, he remains logged 
on. 

Cons c le-Key board Procedures 

There are four control functions 
initiated by the operator from the console 
keyboard: indicating card reader input, 
indicating console-keyboard input, discon- 
tinuing output, and initiating an abnormal 
closedown. 

These functions are initiated by the 
operator pressing the Program Stop and Pro- 
gram Start keys on the console. When the 
message 

*J90 0CR=' (Operator Communication Reguest) 

appears, the operator enters the appropri- 
ate reply to initiate the function he 
desires (see 1130 RJE Messages for replies 
to the 'J90 OCR='' message). 

If the operator has indicated console- 
keyboard input, a iressage 'J93 PROCEED' 
will be displayed and the keyboard select 
light turned on at the time when the pro- 
gram can service keyboard input. The 
operator enters the desired coirmands with 
an EOF at th€ end of each command. After 



entering the last command, an EOF must be 
entered to indicate end of keyboard input,, 
but the keyboard select light must be on 
when it is pressed. 

An abnormal closedown is initiated by 
replying with a T to the *J90 OCR=' mes- 
sage. This reply causes the work station 
program to be terminated and the contents 
of main storage to be written on the print- 
er. The central system logically detaches 
and disconnects the work station, if it is 
connected over a switched line. 

The work station is also logically 
detached from the central system, on a 
leased or multipoint line, if a line opera- 
tion is in progress when the operator 
reguests the termination, or when the cen- 
tral system tries to contact the work sta- 
tion, the program has net been reloaded and 
the line was idle when the reguest was 
made. 

Note : The console-keyboard procedure may 
not be used if the console-keyboard is 
already in use. If it is being used, the 
message is not printed. However, the Pro- 
gram Start key must be pressed in orde.r to 
continue processing. 

Discontinuing Output 

Output can be discontinued by operator 
intervention. The operator uses the 
console-keyboard procedure to initiate the 
reguest and responds by entering a D to 
discontinue output. 

Output is also discontinued by the 1130 
RJE Work Station Prograir when no user- 
written routine is present for output 
directed to the user-exit and when one of 
the following 3 errors occurs: 

1. No area is reserved for user-exit 
output . 

2. The area is exhausted. 

3. A permanent disk write error occurs. 

Once output is discontinued, no other 
output is transmitted to the work station 
until the disposition of the discontinued 
output is specified by the CONTINUE 
command. 

Continuing Output 

Disposition of discontinued output is 
specified with the CONTINUE command. Out- 
put is discontinued if the following condi- 
tions occur: 

1. The remote operator reguests 
discontinuation- 

2. A change in form number is found at 
the central system. 



92 



Form C30-2006-1,, Page Revised by TNL N30-2517, November 1, 1968 



3. The remote program requests discon- 
tinuation (see Discontinuing Output) 

H.. An irrecoverable error occurs during 
an outpit operation- 

If conditions one, two or three occur, the 
disposition cf the output is specified with 
the CONTINUE command. Condition four 
requires error recovery procedures. 

Error Recovery Procedures 

At an 1130 work station, facilities are 
provided to recover from both communication 
errors and local device errors. Operator 
intervention may be necessary to correct 
the condition causing the error. If the 
error cannot be corrected in an allowable 
interval, the central system logically 
detaches the work station from the RJE sys- 
tem. In addition, if the work station is 
connected over a switched line, the central 
system breaks the connection. 

In the case of a local I/O device error,, 
a message is always issued except for forms 
check on the console -printer. This error 
causes the Forms Check light to go on, and 
the operator tells the system to try again 
by turning on console switch 1. The com- 
munications on the line are maintained only 
if the error is corrected within approxi- 
mately 21 seconds. 

An error on an I/O device other than the 
console-keyboard is always followed by a 
message describing what type of error has 
occurred. The explanations for the mes- 
sages and for the actions to be taken by 
the program after the operator's reply are 
described in the 113 RJE Error Messages 
section. 



Restart Procedures 



Restart procedures involve regaining 
communication with the central system and 
submitting an RJSTART command. If the 
error occurs during an output operation, 
output automatically resumes either where 
it was interrupted (after a line error) or 
at the beginning of the job (after a cen- 
tral failure). 



If output is written to disk at the time 
of a line error and it is not a central 
failure, the operator should discontinue 
the output and submit a CONTINUE command 
with the BEGIN operand. 



If the output was written to the punch 
or the printer at the time of a line error, 
and if it was not a central failure,, a dup- 
lication of the last transmission block may 
occur when the program is restarted. The 
printer will skip to a new page when RJE is 
restarted if the data set being printed is 
without control characters. 



If the error occurs during an input 
operation, all unacknowledged input must be 
resubmitted. Furthermore, a line error in 
the middle of a job implies that the whole 
job must be resubmitted from the beginning. 
Before the job can be transmitted again 
with the same jobname, the old job, that 
which was partially sent to the central 
system, must be deleted. Unless the error 
occurs in the middle of reading JECL, RJE 
deletes the job. For errors that occur in 
JECL, the operator must delete the job. 
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1130 RJE ERROR MESSAGES 

The first digit of the messages has the 
following meaning: 



5 - 



I 9 - 



J01 



J10 



Jll 



J14 



Error in RJEOO. 

Error in the initializing part of RJE. 

Error during the processing of the RJE 

program, that does not require an 

operator reply. 

Error during the processing of the RJE 

program, that requires a reply from the 

operator. 

Non-error message. 



INVALID CARD 



Exp 3a nation t This message is 
issued during work station program 
generation. The card containing 
the work station information is 
invalid or contains invalid 
information. (See Generating the 
1130 Work Station Program.) 



System Action : The system exits 
to the Disk Monitor Supervisor. 

Operator Response : The operator 
must reload the generation program 
and enter a valid card. 



INVALID PRINTER 

Explanation : Information from the 
Disk Monitor System indicates that 
the principal print device is not J20 
an 1132 printer or a 1403 printer. 

System Action : The system exits 
to the Disk Monitor Supervisor. 

Operator Response : He may reload 
the RJE program after assigning 
either an 1132 printer or a 1403 
printer as the principal print 
device. 

INVALID READER 



Explanation : Information from the 
Disk Monitor System indicates that 
the principal I/O device for the 
system is not a 14 42 card reader 
or a 2501 card reader. 

System Action : The system exits 
to the Disk Monitor Supervisor. 

Operator Response : He may reload 
the RJE program after assigning 
either a 14 4 2 card reader or a 
2501 card reader as the principal 
I/O device. 



J12 LOGICAL DRIVE x NOT IN SYSTEM 

Explanation : The area on disk 
reserved for user-exit data is on 
a logical disk drive that is not 
present in this RJE run. The 
logical disk drive asked for 
replaces x in the message. 

System Action : The system exits 
to the Disk Monitor Supervisor. 

Operator Response : He may reload 
the RJE prograir after having 
changed the user-exit parameters 
or after having introduced the 
requested logical disk drive. 

DISK ERROR OCR= 

Explanation : A permanent error 
has been encountered while 
attempting to read data from disk 
during the initializing part of 
the RJE prograir. 

System Action : The system 
continues according to the 
operator response. 

Operator Response : The operator 
must enter one of the following 
codes : 

T - Terminate RJE processing by 
exiting to the Disk Monitor 
and dumping core. 

X - Exit to the Disk Monitor. 

RJSTART MISSING 

Explanation : The requirement for 
an RJSTART comirand was not 
satisfied. 

System Action : The system waits 
for operator action. 

Operator Response : The operator 
must enter an RJSTART command 
through the card reader and press 
PROGRAM START in order to resume 
processing- 

J21 . . DATA INVALID 

Explanation : A . . DATA statement 
contains invalid parameters. 

System Action : The system 
maintains the line operations. 

Operator Response : To continue 
RJE processing, the operator must 
use the Operator Communication 
Request facility (see 'J90 OCR=" 
message) . 
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Note: This iressage is also issued 
if the logical disk drive referred 
to is net present. 

J22 INVALID INPUT 

Explanation : The input entered 

from the console- keyboard does not 

start with the JECL identifier 

(..) followed by at least one J51 

blank. 



Operator Response ; When the 
message is received from the 
central system, the operator 
inspects the message and takes the 
indicated action. To resume input 
the operator must follow the 
procedures listed under 
Console-Keyboard Procedures. 

LINE ERROR OCR= 



J23 



System Action ; The system waits 
for more input from the 
console-keyboard. 

Operator Response ; The operator 
must enter a work station command 
or press the EOF key. 



INPUT ABORTED BY CENTRAL 

Explanation : The central system 
has aborted input from the work 
station and will send a message 
explaining why the input was 
aborted. (For details on messages 
received, see Messages Sent to 
Work Stations.) 

System Action ; The system waits 
for input from the line. 



Explanation : An irrecoverable 
error has been encountered while 
reading or writing on the 
communication line, or the line 
cannot be opened. 

System Action ; The RJE program 
closes the communication line if 
it is open and waits for an 
operator response. 

Operator Response : The operator 
must reply by entering one of the 
following codes from the 
console-keyboard. 

A - Input is available at the card 
reader. If this option is 
selected, the first card in 
the card reader must be an 
RJSTART coirmand. 
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J52 



Cn a switched line, the line 
has to be disconnected before 
the restart is tried. If this 
is not done automatically,, it 
has to be done by the 
perator. He has to dial 
again when the message J91 
ESTABLISH LINE CONNECTION is 
issued. 

X - Exit to the Disk Monitor. 
T - Terminate RJE processing by 

exiting to the Disk Monitor 

and dumping core. 

DISK ERROR INPUT OCR= 

Exp l anation ; A permanent error 
has been encountered while 
attempting to iread input from 
disk. This message is issued only 
if a user's disk input is being 
read at the time the error occurs. 

System Action ; Reading of the 
input data file(s) and card reader 
input is discontinued. Any 
available output from the central 
system is accepted after the 
operaitor response has been 
entered. The system continues 
according to the operator's 
response. 



Operator Response ; The operator 
must enter one of the following 
codes. The response irust be 
entered within approximately 3 
minvtes on a switched line. 



J54 



Operator Response ; The operator 
roust enter one of the following 
codes. For switched lines, the 
response must te entered within 
approximately 3 minutes. 



A - Input is available at the card 
reader. (Any pending keyboard 
input is processed first.) 

B - Comirands are to be read from 
the console-keyboard. 

C - Any pending input is 

processed. If no pending 
input exists, the system will 
maintain the line operations. 

T - Terminate processing by 

exiting to the Disk Monitor 
and dumping core. 

DISK ERROR OCR= 

Explanation ; A permanent error 
has been encountered while 
attempting to read RJE constants 
or error messages from disk. If 
this message appears, an RJE error 
message may be missing. 

System Action ; The system 
continues according to the 
operator response. 

Operator Response ; The operator 
must enter one of the following 
codes: 



A - Input is available at the card 
reader. 



X - Exit to the Disk Monitor. 



B - Commands are to be read from 
the console-keyboard. 

C - Available : output is accepted. 
(Any pending keyboard input is 
processed first. ) 

T - Terminate processing by 

exiting to the Disk Monitor 
and dumping core. 

J53 DISK ERROR OUTPUT OCR= 

Explanation ; A permanent error 
has been encountered while 
attempting to write data on disk. 
This message is issued only if 
user-exit data is being written on 
disk by the IBM supplied user-exit 
routine. 

System Action ; Output from the 
central system is discontinued. 
The system continues as directed 
by the operator response. 



T - Terminate processing by 

exiting to the Disk Monitor 
and dumping core. 

J55 END OF DISK AREA OCR= 

Explanation ; The user has failed 
to reserve space or has reserved 
too little space on disk for 
user-exit output data sets. 

System Action : Output from the 
central system is discontinued. 
The system continues as directed 
by the operator response. 

Operator Response ; The operator 
must enter one of the following 
codes. For switched lines, the 
response must be entered within 
approximately 3 minutes. 

A - Input is available at the card 
reader. (Any pending keyboard 
input is processed first.) 
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J56 



J57 



J58 



B - Commands are to be read from 
the console-keyboard. 

C - Any pending input is 

processed. If no pending 
input exists, the system will 
naintain the line operations. 

T - Terminate processing by 

exiting to the Disk Monitor 
end dumping core. 

CARD READER ERROR OCR= 



Explanation : An error that 
requires operator intervention has 
occurred en the card reader. 

System Action ; The system waits 
for the operator* s reply. 

Operator Response ; The operator 
must enter one of the following 
codes. The response must be 
entered within approximately 3 
minrtes on a switched line. 

A - The operator has corrected the 
problem and the program will 
lesume card reader input. 

E - The operator could not correct 
the problem. The program 
assumes reading and 
€nd-of-file (.. null card) 
indication on the card reader. 

CARD PUNCH ERROR OCR= 

Explanation ; An error that 
requires operator intervention has 
occurred on the card punch. 

System Acti on; The system waits 
for the operator reply. 

Operator Response ; The operator 
must enter one of the following 
codes, within approximately three 
minutes on a switched line 
connection. 

D - The operator could not correct 
the problem. Output from the 
central system is discontinued 
and a . . CONTINUE command must 
he transmitted to resume 
cut put. 

P - The operator has corrected the 
problem and the program will 
iesume card punch output. 

PRINTER ERROR OCR= 



Explanation ; An error that 
requires operator intervention has 
occurred on the printer. 



System Action ; The system waits 
for operator reply. 

Operator Response ; The operator 
must enter one of the following 
codes, which must be entered 
within three minutes on a switched 
line. 

D - The operator could not correct 
the error. Output from the 
central system is discontinued 
and a . . CONTINUE command must 
be transmitted to resume 
output operation. 

P - The operator has corrected the 
error and the program will 
resume printer output. 

J59 PREOPERATIVE EFROR CODE XXXX OCR= 

Explanation ; A pre-operative 
error has occurred in the 
user-exit routine, or a logical 
disk drive that is ready during 
the loading of the work station 
program and used in the processing 
of the preceding job has been 
referenced and found to be not 
ready. The preoperative error 
code as defined in Appendix A„ IBM 
1130 Disk Monitor System, Version 
2, Programming and Operator's 
Guide , Form C26-3717, replaces 
XXXX. 

System Action ; The system waits 
for the operator reply. 

Operator Response ; The operator 
must enter one of the following 
codes within approximately three 
minutes on a switched line 
connection. 

C - The operator has corrected the 
error and the program will 
retry the operation. 

T - Exit to the Disk Monitor 
Supervisor requesting a 
terminating dump of the 
contents of main storage 
written on the printer- 

X - Exit to the Disk Monitor 

Supervisor without writing the 
contents of main storage on 
the printer. 
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1130 PJE MESSAGES 



J90 CCR= Operator communication request 
recognized 

Explanation : The RJE program is 
ready to service an operator 
request. The operator indicates 
that he wants to communicate with 
the 1130 RJE Work Station Program 
by pressing the Program Stop key 
and then the Program Start key. 



System Action ; 
for the reply. 



The system waits 



Operator Response ; The operator 
enters one of the following codes. 
The response roust be entered 
within approximately 21 seconds 
for switched lines and also within 
the same limit for leased and 
multipoint lines, if a line 
operation is in progress. 

A - Input is available at the card 

reader. 
B - Commands are to be read from 

the ccnscle-keyboard. 
D - Discontinue receiving output. 
N - Ignore the request. 
T - Terminate processing by 

exiting to the Disk Monitor 

and dumping core. 



| J91 ESTABLISH LINE CONNECTION 



Explanation ; This message is 
displayed only at an 1130 work 
station on a switched line- The 
operator is to establish a 
connection with the central 
syst em . 

System Acti on : The system 
continues to check for a completed 
connection. When the connection 
is established, the system resumes 
processing. 

Operator Response ; The operator 
must perform the dial-up procedure 
to establish the connection with 
the central system. 



rrrr - The logical record length 
in hexadecimal for fixed 
length records. 

c - The type of control 

characters used; c may have 
the following values: 

- No control characters 

are used. 

1 - System/360 machine code 

control characters are 
used. 

2 - ASA control characters 

are used. 

f - The OS/360 record format; f 
may have the following 
values : 

1 - Fixed unblocked records 

2 - Fixed blocked records 

3 - Variable unblocked 

records 

4 - Variable blocked 

records 

5 - Undefined records 

x - The logical disk drive 
number. 

aaa - The sector address in 
hexadecimal. 

bbbb - The length of the data set 
in blocks where there are 
40 packed EBCDIC characters 
per block (16 blocks per 
sector) . The last block 
need not be filled. 



System Action 
set is writte 
block length 
the message i 
data set is c 
if a line err 
occurs before 
is received, 
message remai 



: The user-exit data 
n on disk. The disk 
information part of 
s written when the 
ompleted; therefore, 
or or a disk error 

the whole data set 
this portion of the 
ns blank. 



Operator Response : None. 



| J93 PROCEED 



OPERATOR MESSAGES 

J92 DATA rrrrOcOf TO DISK AT xaaa, bbbb 

Explanation ; This message is 
received cnly when no user-written 
routine is present. The RJE 
program is writing user-exit data 
to disk. The message codes have 
the following meanings: 



Explanation ; This message is 
displayed as a result of a B reply 
to an 'J90 OCR=* message. The 
work station is ready to receive 
commands from the con sol e- 
keyboard. 

System Action ; The keyboard 
select light is turned on and the 
program waits for input from the 
console-keyboard. 
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Operator Response : The operator 



enters the 
an EOF afte 
entering th 
enters anct 
that he has 
console-key 
line, the o 
approximate 
enter each 



desired commands with 
r each command. After 
e last command, he 
her EOF to indicate 
finished using the 
board. On a switched 
p era tor has 
ly three minutes to 
coirmand. 



J94 PUNCHED OUTPUT 

Nonblank card at punch station 

Explanation : A SYSOUT data set is 
to be punched on a 14 42 model 6 or 
model 7 card read punch unit which 
is also used to read card input, 
and a ncnblank card is at the 
punch station. 

System Action : The system waits 
for operator action. 

Operator Response : The operator 
may load fclank cards in the punch 
and then presses any character key 
cr the space tar to resume 



processing. If he wants the 
output to be punched in the 
prepunched cards already in the 
punch unit, he simply presses any 
character key cr the space bar as 
indicated above. 

The operator must take action 
within approximately 21 seconds to 
maintain line communication. If 
this time limit is exceeded, a 
line error will occur. The RJE 
program is restarted according to 
the description under the 'J51 
LINE ERROR OCR=' message. The 
punched output will come if an 
RJSTART command, a null statement 
and the blank cards to be punched, 
in this mentioned order, are put 
in the card reader, and the 
operator then replies A to the 
line error message. 



Note : If punched output is to be 
sent to a 144 2 card read punch, 
which is also used for reading, 
all punched output should be 
specified as deferred. 
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USER EXIT INTERFACE 

The RJE program passes physical records 
to the user-written output routine. The 
user's routine has to save index registers 
1 and 3 for the RJE support. The user must 
name the routine entry point UEXIT and must 
store this routine in the User Area (after 
deleting the resident module with the same 
name) prior to RJE processing. 

The user-exit routine receives control 
when output becomes available for it. Upon 
entry, the return address is stored in the 
first word of the routine. Register 1 con- 
tains the address of a parameter list 
describing the output passed to the rou- 
tine. This parameter list is aligned on an 
even word boundary. The format of this 
list is: 



Note ; The user-written routine must return 
control to RJE within approximately 21 
seconds in order to maintain the communi- 
cation line connection. If the user 
exceeds this time limit , the central RJE 
program logically detaches the work station 
and also disconnects the work station if it 
is attached on a switched line. 

JECL FOR THE 1130 WORK STATION 

JECL statements used for the 1130 work 
station are the same as those described 
under Job Entry Control Language, with one 
addition. The additional statement allows 
the user to alternate the source of his 
input between disk input and card input. 

The format of this statement is: 










One Word (16 bits) 

Starting Address 



Ending Address 

Logical Record Length 
+3| 



Control Character Type 

Record Format 
+ 5j- 

End of Data 

L 



j ID j Operation j Operand 
|.. | DATA |DMS r C 



,D,xaaa [,bbbb] 



— —4 DATA 



DMS 



is the JECL identifier and must be in 
columns one and two. 

must be preceded and followed by at 
least one blank. 

identifies the card as an 1130 JECL 
statement. 



Starting Address : The address of the block 
received from the central system. 

Ending Address : The ending address* 1 of 
the block received from the central system. 

Logical Record Length : The length of log- 
ical records when fixed length records are 
passed. 

Control Character Type : The type of con- 
trol characters being used. 

- No control character 

1 - System/360 machine code 

2 - ASA code 

OS/360 Record Format : The code indicating 
the type of record. 

1 - Fixed unblocked 

2 - Fixed blocked 

3 - Variable unblocked 

4 - Variable blocked 

5 - Undefined 

End of Data : If zero, indicates end of 
data. 

The user-written routine must use the 
same I/O routines as the 1130 RJE program 
for printer, punch, console- keyboard, and 
disk. DISKZ is used for disk I/O. 



indicates that input follows on cards, 
indicates that input follows on disk: 



aaa 



bbbb 



is the logical disk drive number, 

is the sector address, 

is a hexadecimal number specify- 
ing the length of the disk data 
file in blocks where there are 
two blocks per 80-character rec- 
ord ( 16 blocks per sector) . 



If D is specified, the disk number and 
the sector address are required, but the 
block count is optional. When the block 
count is not specified, the user must indi- 
cate the end of data on disk by using a 
. . DATA statement to transfer reading of 
data to the card reader or to another disk 
area. The optional block count for disk 
data causes the RJE program to read data 
from disk until the specified number of 
blocks has been read, unless the end-of- 
data indication is encountered first. If 
the RJE program reads the specified number 
of blocks without detecting end-of-data, 
reading from disk terminates and reading 
continues from the card reader. 



IBM 1130 Computing System 97 



Form C30--2006-1, Page Revised by TNL N30-2510, 5/1/68 



Data on disk must start at the beginning 
of a sector and continue on consecutive 
sectors if necessary. Each sector must 
contain eight 80-character records in 8-bit 
code, but the last sector need not be 
filled. ' 

The . . DATA card is not recognized 
between a // DD DATA card and the cor- 
responding /* in an OS/360 job. 



| UEXIT= (address 1 , address 2) 



address 1 is the starting address on 
disk reserved for storing 
data directed to user €>xit. 

address 2 is the ending address of 
the area reserved on dj.sk 
for storing data directed 
to the user exit. 

Addresses must be in the form xaaa 

where: 



Note: 



The 



DATA statement is the only 



JECL statement that is not intersystem com- 
patible when used on other work stations. 



GENERATING THE 1130 WORK STATION PROGRAM 

The object modules for the Remote Work 
Station Program reside in the user area on 
disk. The 1130 Work Station Program is 
loaded by an XEQ control card. 

The user describes the work station con- 
figuration by executing the program named 
RJE00 once. This program reads in one data 
card, supplied by the user, which contains 
parameters describing line configuration 
and space reserved for data output on disk, 
if any. If a parameter is specified, the 
parameter name and equal sign must be used 
as shown in the explanation below. The 
parameters can be in any order, and if both 
of them are specified, they have to be 
separated by a comma. The default for LINE 
parameter is to the LINE indication that 
was specified in the previous job (the 
first time through, the default is to 
LINE=P) . 



is the logical disk drive number. 



LINE=P 
LINE=S 
LINE=M(x,y) 



UEXIT= (address 1 , address 2) 



LINE=P 
LINE=S 
LINE=M(x,y) 

specifies the type of line connection 

used by the work station. 



specifies point-to-point communi- 
cation over a nonswitched line. 

specifies point-to-point communi- 
cation over a switched line. 



M (x,y) 



specifies a multipoint line 
where: 



aaa 



is the sector number. 
The area specified must be reserved by 
the user prior to RJE processing. 

RJE00 stores the information found in 
the parameters, in an area on disk reserved 
for common constants. Once RJE00 has been 
executed, it need not be executed again 
unless the original information changes. 

The final step in preparing the system 
for processing is the execution of the RJE 
program. This program uses the information 
stored on disk by RJE00 and the information 
in the disk monitor system which specifies 
principal I/O devices to load the modules, 
residing in the system library, correspond- 
ing to the user's configuration. Note that 
the console-printer cannot be the principal 
print device. 

Example 1 : Entering Work Station 
Information 

// JOB 

// XEQ RJE 00 

LINE=M (A,B) ,UEXIT= (21B0,22B0) 

The first two cards are the control 
cards needed to load the program that pro- 
cesses the information in the third card. 
This card specifies that the RJE work sta- 
tion is On a multipoint line, that its 
polling character is A, and its selection 
character B. For storing of data that is 
directed to the user exit, the user has 
reserved an area on disk drive 2 starting 
at sector 1B0 and ending with sector 2B0. 

Example 2: Executing the RJE Program 

// JOB 

// XEQ RJE 

.. RJSTART 

JECL statements and OS/360 job 
.. RJEND 



is the polling character; 

y 

is the selection character. 

If this parameter is omitted, the line 
information will not be changed. 



The first two cards are used by the disk 
monitor system to load and start execution 
of the RJE work station program. After 
these cards, the JECL statements and the 
OS/360 jobs follow in the proper sequence. 
An RJSTART command must be the first card. 
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APPENDIX A: SAMPLE RJE JOB STREAM 



An example of a Remote Job Entry job 
stream, submitted only from BOS/BPS work 
stations , with messages and output as they 
appear on both remote and central printers, 
and on printer-keyboards follows. Users 
have several options which control the 
appearance of certain messages. In this 
example user RTP has set bit 1 of the UPS I 
switch so that his JECL will appear on his 
printer- keyboard. He has set bit 2 of the 
UPSI switch so that the RJE messages will 
appear on his printer-keyboard rather than 
the line printer. For the 1130 work sta- 
tion user RTP has console switch zero off 
so that the RJE messages will appear on his 
printer-keyboard rather than on the line 
printer. And, he has specified a JOBACK 
user exit which builds a message to follow 
the JOBACK message built by RJE. 

User RTP submits items 1-6 at the card 
reader. As they are read, they are dis- 
played on his printer- keyboard. Notice 
that the protection key in the LOGON com- 
mand is not displayed at the printer- 
keyboard. While the cards are being read 
and transmitted to the central installa- 
tion, the responses to the commands begin 
to appear on the remote printer-keyboard. 
Since BRDCST=YES is specified on the 
RJSTART command (1) , any active broadcast 
messages are returned to the work station 
with the RJSTART accepted message. The 
LOGON accepted message follows (2) . 

As soon as the central RJE system 
receives the two jobs, it returns job 
accepted messages with the user-built mes- 
sages (3) , (4) » After job D12 starts, the 
central operator enters a SHOW JOBS command 
(7) and learns that there are two jobs in 



the RJE system, neither of which is com- 
plete. After the D12 ENDED message appears 
at the central printer-keyboard, the output 
is transmitted to the remote work station. 
The JED option specified is CENTRAL=ALL 
(3) , so that only the JCL is returned to 
the remote printer. The output from both 
the link edit and go steps appears on the 
central printer. 

The JED option for job D16 specifies 
that the output is deferred (4) , so it is 
not transmitted. However, there is an 
ALERT waiting for this job, so RTP receives 
a notification of job completion (5) . 
Notice that this happens after D16 ENDED 
appears at the central printer-keyboard. 

Now user POK submits items 8-12 and logs 
on (8) . The ALERT (9) submitted by POK 
gets an immediate response since D16 is 
already complete. The OUTPUT command (10) 
does not cause the output from D16 to be 
returned because POK is the alternate user 
rather than the source. POK then receives 
a notice that his alerts have been can- 
celled as a result of the ALERT / (11) . 
The STATUS command indicates that D16 com- 
pleted normally (12) , so POK submits an 
OUTPUT * (13) and receives the job output 
(13) at the remote printer. 

Then POK submits an RJEND (14) , thus 
logging off and placing the work station in 
an inactive state. 



Note : The T's shown in the example repre- 
sent optional sequence numbers, up to eight 
alphameric characters, contained in columns 
73-80 of each card in the job stream. 
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CENTRAL PRINTER KEYBOARD 



REMOTE PRINTER/CENTRAL PRINTER 



(3) 

IEF403I D12 STARTED 



(7) 

show jobs 

IHK005I JOB(s) NOT COMPLETE D12 RTP 

IHK005I JOB(s) NOT COMPLETE D16 RTP 

(3) 

IEF404I D12 ENDED 

(4) 

IEF403I D16 STARTED 



(4) 

IEF404I D16 ENDED 



(3) 

//D12 JOB MSGLEVEL=1,REGION=100K (3) 

— JECL and a I location messages — 

output from linkedit step 

output from go step 



03) 

//D16 JOB MSGLEVEL=1,REGION=100K (4) 

— JCL and allocation messages — 

output from linkedit step 

— JCL and allocation messages — 
output from go step 
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REMOTE CARD READER INPUT 



REMOTE PRINTER KEYBOARD 



REMOTE 1130 PRINTER KEYBOARD 



0) 

. . RJ START RALEIGH, BRDCST=YES Tl 

(2) 

. . LOGON RTP,XYZ T2 



(3) 

. . JED CENTRAL=ALL T3 

//D12 JOB MSGLEVEL=1,REGION=100K 

// EXEC LKEDG 

//LKED.SYSIN DD * 

— object modules — 

/* 

//GO.DATAOUT DD SYSOUT=A 

//GO.SYSIN DD * 

— data — 

/* 

(4) 

. JEDOUTPUT=(DEFER,POK) T4 

//D16 JOB MSGLEVEL=1,REGION=100K 

// EXEC LKEDG 

//LKED.SYSIN DD * 

— data — 

/* 



<a\ 



ALERT D16 



(6) 



LOGOFF 



(8) 

. . LOGON POK,ABC 

(9) 

. . ALERT * 



15 
T6 



00) 

. . OUTPUT 



01) 

. . ALERT/ 

02) 

. . STATUS U=RTP 



03) 

. . OUTPUT 



04) 



RJEND 



0) 

. . RJ START RALEIGH, BRDCST=YES 

(2) 

. . LOGON RTP, 

IHK120I BROADCAST MESSAGES FOLLOW 

— broadcast messages - if there are any — 

IHK120I BROADCAST MESSAGES END 

— delayed messages - if there are any — 

IHK100I RJ START ACCEPTED Tl 

IHK101I USER LOGGED ON RTP T2 (2) 



Tl 



T2 



(3) 



JED CENTRA L=ALL 



T3 



(4) 



JED OUTPUT=(DEFER,POK) 



T4 



(3) 

IHK117I JOB ACCEPTED D12 RTP EXECUTING JED 

***THIS MESSAGE BUILT BY JOBACK USER EXIT 

(4) 

IHK117I JOB ACCEPTED D16 RTP EXECUTING JED 

***THIS MESSAGE BUILT BY JOBACK USER EXIT 



(5) 



ALERT D16 



LOGOFF 



(6) 

(6) 

IHK102I USER LOGGED OFF RTP 

C5) 

IHK109I NOTIFY D16 RTP 



T5 



T6 



LOGON POK, 



(8) 

(8) 

IHK101I USER LOGGED ON POK 

(9) 

. . ALERT * 

(9) 

IHK109I NOTIFY D16 POK 

(10) 

. . OUTPUT 

00) 

IHK154I NO AVAILABLE OUTPUT POK 

01) 

. . ALERT/ 

02) 

. . STATUS U=RTP 

01) 

IHK115I ALERTS CANCELLED POK 

(12) 

IHK108I STATUS D16 RTP NORMAL END 



03) 

. . OUTPUT * 

04) 

. . RJEND 

04) 

IHK103I RJEND ACCEPTED 



0) 

IHK120I BROADCAST MESSAGES FOLLOW 

— broadcast message - if there are any — 

IHK120I BROADCAST MESSAGES END 

— delayed messages - if there are any — 

IHK100I RJ START ACCEPTED Tl 

(2) 

IHK101I USER LOGGED ON RTP T2 



(3) 

IHK117I JOB ACCEPTED D12 RTP EXECUTING JED 

***THIS MESSAGE BUILT BY JOBACK USER EXIT 

(4) 

IHK117I JOB ACCEPTED D16 RTP EXECUTING JED 

***THIS MESSAGE BUILT BY JOBACK USER EXIT 



(6) 

IHK102I USER LOGGED OFF RTP T6 



(5) 

IHK109I NOTIFY D16 RTP 

(8) 

IHK101I USER LOGGED ON POK 



(9) 

IHK109I NOTIFY D16 POK 



00) 

IHK154I NOT AVAILABLE OUTPUT POK 



01) 

IHK115I ALERTS CANCELLED POK 

02) 

IHK108I STATUS D16 RTP NORMAL END 



(14) 

IHK103I RJEND ACCEPTED 
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APPENDIX B; STORAGE REQUIREMENTS 



CORE REQUIREMENTS 



(1) RJE Region 

The following algorithm can be used to 
determine the size of the RJE region. 

71304+408A+1752B+68C+24D+18E+96F+48G+ 
[(624+N.,) + (624+N 2 ) +... (624+N n ) ] 1 

where 

A = number of line groups - from RJE- 
LINE macros. 

B = number of lines - from RJELINE 
macros . 

C = number of work stations - from 
RJETERM macros. 

D = maximum number of jobs in system - 
from RJETABL macro. 

E = maximum number of users - from 
RJEUSER macro. 

F = maximum number of central RJE com- 
mands queued - from RJETABL macro. 

G = number of completed jobs which 
have not yet been sent back. 

N, to N n = block size of the SYSOUT 
data set for each line. 

The number of members of the series 
[ (624+N,,) + (624+N 2 ) +. . . (624+Nn) ] is deter- 
mined by the maximum number of lines simul- 
taneously sending output. 

Note : This algorithm assumes that the 
modules IEFVHA and IEFQMSSS are in the link 
pack area. If they are not, 32,871 bytes 
must be added to the above result. 

In installations expecting to run RJE 
concurrently with local readers, it is 
desirable to load the two modules in the 
the multiple readers. If little concurrent 
usage of multiple readers is expected, the 
modules should not be included in the link 
pack area. This will make the additional 
32K available when the STOP RJE command is 
issued. 



(2) System Queue Space 

The size of the system queue space for 
RJE can be calculated with the following 
algorithm: 

3072+92A+100B+80C+144D 



where 



A = number of line groups - from RJE- 
LINE macros. 

B = number of lines - from RJELINE: 
macros . 

C = number of nonresident RJE modules 
that are active at one time 
(assume 1 or 2 as an average) . 

D = number of access method modules 
that are active at one time (4 is 
the maximum for BTAM and they are 
usually all active; assume an 
average of 1 or 2 for BSAM or 
BDAM) . 



DIRECT ADDESS REQUIREMENTS 



(1) 2311 Disk Storage Drive 

The requirements for direct access space 
on the IBM 2311 Disk Storage Drive are cal- 
culated by use of the following algorithm: 

J_ J_ U_ W_ 
42+22+46+27+11 

where 



J = number of jobs in system. 
U = number of users. 
W = number of work stations. 
Q indicates raising the result to 
2314 Direct Access Storage Facility 



(2) 



11 The sum within the brackets and 49G must 
each be raised to the next multiple of 2K 
and the entire total raised to the next 
multiple of 2K. 



Requirements for direct access storage 
space in the IBM 2314 Storage Facility are 
calcu ated using the following algorithm: 

J J U W 

58+36+62+43+8 

The symbols used are explained under the 
section for the 2311. 
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APPENDIX C: PERFORMANCE GUIDELINES 



The ability of the RJE system to provide 
proper service to each line in the system 
is dependent upon the number of lines 
attached and concurrently operating. 

The maximum number of lines which can be 
properly supported is dependent on many 
variables including CPU size, line speed, 
job mix, channel and disk arm contention, 
etc. 

Although this number is difficult to 
predict, the system does provide clues that 
the optimum performance point for any par- 
ticular configuration has been passed. 
These clues are in the form of the follow- 
ing messages at the central console: 

IEA0001 I/O ERR, XXX, 02, 0D00, 

0000V91 000000 

IEA0001 I/O ERR, XXX, 01, 0D00, 

0000V08000000 



Priority Queuing is specified in the 
system generation IODEVICE macro for 
DASDs containing highly utilized RJE 
data sets (including SYS 1 . LINKLIB , 
SYS 1 . SVCLIB , and SYS 1 . SYS JOBQE) . 



Maximum use of the LINKPACK and resi- 
dent SVC options are made. This 
includes particularly the following 
modules: 



IEFVHA 

IEFQMSSS 

IGC0002B 

IGC0002C 

IGG0230C 

IGG0230D 

IGC0003B 

IGC0003E 

IGC0006D 



where 



XXX 



is the line address 



When these messages occur at the central 
CPU, the remote work station associated 
with line XXX is logically disconnected 
from the system and an RJSTART is required 
to resume communication. This has the 
effect of temporarily reducing the load on 
the system and allowing it to service the 
remaining lines properly. 

Insofar as the specific machine configu- 
ration allows, observance of certain guide- 
lines insures optimum performance from the 
system. Particularly if the messages 
described above appear, any or all of the 
following options should be incorporated 
into the system: 

• SYS1. LINKLIB, SYS1. SVCLIB, SYS1. 
SYSJOBQE as well as any other highly 
utilized data sets (e.g., SYS1.FORTLIB 
in a primarily FORTRAN shop) are placed 
on separate devices and separate 
channels . 

• SYSIN blocking of 400 characters per 
block is specified in the RJE 
procedure . 



• The following module names are included 
in a BLDL list. 

IEFLOCDQ 
IHKABRER 
IHKCAOSR 
IHKCASHB 
IHKCASHD 
IHKCASHJ 
IHKCASHL 
IHKCASHM 
IHKCASHO 
IHKCASHT 
IHKCASHU 
IHKCBUID 
IHKCDBDC 
IHKCDBIN 
IHKCDBIS 
IHKCDBPK 
IHKCDBSH 
IHKCDBTW 
IHKCDBTX 
IHKCDMDE 
IHKCDMDQ 
IHKCDMEQ 
IHKCDRMV 
IHKCGCNT 

The use of the link pack, resident SVC, 
and BLDL options is described in the publi- 
cation IBM System/360 Operating System: 
System Programmer's Guide . 
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